diff --git a/.gitmodules b/.gitmodules
index 3e3d7e2c..191af28d 100644
--- a/.gitmodules
+++ b/.gitmodules
@@ -1,9 +1,11 @@
[submodule "contrib/miniupnp"]
path = contrib/miniupnp
url = https://github.com/miniupnp/miniupnp
-[submodule "contrib/db/libmdbx"]
- path = contrib/db/libmdbx
- url = https://github.com/leo-yuriev/libmdbx.git
[submodule "src/gui/qt-daemon/layout"]
path = src/gui/qt-daemon/layout
url = https://github.com/hyle-team/zano_ui.git
+ branch = main
+[submodule "contrib/tor-connect"]
+ path = contrib/tor-connect
+ url = https://github.com/hyle-team/tor-connect.git
+ branch = main
\ No newline at end of file
diff --git a/CMakeLists.txt b/CMakeLists.txt
index f21fb093..99243a7d 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -56,18 +56,23 @@ if(APPLE)
endif()
set(USE_PCH FALSE CACHE BOOL "Use shared precompiled headers")
+set(DISABLE_TOR FALSE CACHE BOOL "Disable TOR library(and related tor-connect submodule)")
+set(TESTNET FALSE CACHE BOOL "Compile for testnet")
+set(BUILD_GUI FALSE CACHE BOOL "Build qt-daemon")
include_directories(src contrib/eos_portable_archive contrib contrib/epee/include "${CMAKE_BINARY_DIR}/version" "${CMAKE_BINARY_DIR}/contrib/zlib")
add_definitions(-DSTATICLIB)
-set(TESTNET FALSE CACHE BOOL "Compile for testnet")
if(TESTNET)
message("!!!!!! NOTICE: Project is building for TESTNET !!!!!!")
add_definitions(-DTESTNET)
endif()
-set(BUILD_GUI FALSE CACHE BOOL "Build qt-daemon")
+if(DISABLE_TOR)
+ message("NOTICE: Building with disabled TOR support!")
+ add_definitions(-DDISABLE_TOR)
+endif()
set(STATIC ${MSVC} CACHE BOOL "Link libraries statically")
@@ -197,7 +202,7 @@ elseif(CMAKE_SYSTEM_NAME STREQUAL "Android")
set(Boost_LIBRARY_DIRS "${Boost_LIBRARY_DIRS}/${CMAKE_ANDROID_ARCH_ABI}/")
set(Boost_LIBRARIES "${Boost_LIBRARY_DIRS}libboost_system.a;${Boost_LIBRARY_DIRS}libboost_filesystem.a;${Boost_LIBRARY_DIRS}libboost_thread.a;${Boost_LIBRARY_DIRS}libboost_timer.a;${Boost_LIBRARY_DIRS}libboost_date_time.a;${Boost_LIBRARY_DIRS}libboost_chrono.a;${Boost_LIBRARY_DIRS}libboost_regex.a;${Boost_LIBRARY_DIRS}libboost_serialization.a;${Boost_LIBRARY_DIRS}libboost_atomic.a;${Boost_LIBRARY_DIRS}libboost_program_options.a")
else()
- find_package(Boost 1.55 REQUIRED COMPONENTS system filesystem thread timer date_time chrono regex serialization atomic program_options locale)
+ find_package(Boost 1.70 REQUIRED COMPONENTS system filesystem thread timer date_time chrono regex serialization atomic program_options locale)
endif()
diff --git a/README.md b/README.md
index 189c88cf..c6ad2f56 100644
--- a/README.md
+++ b/README.md
@@ -18,7 +18,8 @@ Be sure to clone the repository properly:\
| [MSVC](https://visualstudio.microsoft.com/downloads/) (Windows) | 2015 (14.0 update 1) | 2017 (15.9.0) | 2019 |
| [XCode](https://developer.apple.com/downloads/) (macOS) | 9.2 | 12.3 | 12.3 |
| [CMake](https://cmake.org/download/) | 2.8.6 | 3.15.5 | 3.20 |
-| [Boost](https://www.boost.org/users/download/) | 1.56 | 1.68 | 1.76 |
+| [Boost](https://www.boost.org/users/download/) | 1.70 | 1.70 | 1.76 |
+| [OpenSSL](https://www.openssl.org/source/) [(win)](https://slproweb.com/products/Win32OpenSSL.html) | - | 1.1.1n | 1.1.1n |
| [Qt](https://download.qt.io/archive/qt/) (*only for GUI*) | 5.8.0 | 5.11.2 | 5.15.2 |
Note:\
@@ -35,18 +36,18 @@ Recommended OS version: Ubuntu 18.04 LTS.
[*server version*]
- sudo apt-get install -y build-essential g++ python-dev autotools-dev libicu-dev libbz2-dev cmake git screen
+ sudo apt-get install -y build-essential g++ python-dev autotools-dev libicu-dev libbz2-dev cmake git screen checkinstall zlib1g-dev
[*GUI version*]
- sudo apt-get install -y build-essential g++ python-dev autotools-dev libicu-dev libbz2-dev cmake git screen mesa-common-dev libglu1-mesa-dev
+ sudo apt-get install -y build-essential g++ python-dev autotools-dev libicu-dev libbz2-dev cmake git screen checkinstall zlib1g-dev mesa-common-dev libglu1-mesa-dev
2. Download and build Boost
- wget https://boostorg.jfrog.io/artifactory/main/release/1.68.0/source/boost_1_68_0.tar.bz2
- tar -xjf boost_1_68_0.tar.bz2
- cd boost_1_68_0
- ./bootstrap.sh --with-libraries=system,filesystem,thread,date_time,chrono,regex,serialization,atomic,program_options,locale,timer
+ curl -OL https://boostorg.jfrog.io/artifactory/main/release/1.70.0/source/boost_1_70_0.tar.bz2
+ tar -xjf boost_1_70_0.tar.bz2
+ cd boost_1_70_0
+ ./bootstrap.sh --with-libraries=system,filesystem,thread,date_time,chrono,regex,serialization,atomic,program_options,locale,timer,log
./b2
3. Install Qt\
@@ -54,28 +55,44 @@ Recommended OS version: Ubuntu 18.04 LTS.
[*GUI version*]
- wget https://download.qt.io/new_archive/qt/5.11/5.11.2/qt-opensource-linux-x64-5.11.2.run
+ curl -OL https://download.qt.io/new_archive/qt/5.11/5.11.2/qt-opensource-linux-x64-5.11.2.run
chmod +x qt-opensource-linux-x64-5.11.2.run
./qt-opensource-linux-x64-5.11.2.run
Then follow the instructions in Wizard. Don't forget to tick the WebEngine module checkbox!
-4. Set environment variables properly\
+
+4. Install OpenSSL
+
+ We recommend installing OpenSSL v1.1.1n locally unless you would like to use the same version system-wide.
+
+ curl -OL https://www.openssl.org/source/openssl-1.1.1n.tar.gz
+ tar xaf openssl-1.1.1n.tar.gz
+ cd openssl-1.1.1n/
+ ./config --prefix=/home/user/openssl --openssldir=/home/user/openssl shared zlib
+ make
+ make test
+ make install
+
+
+5. Set environment variables properly\
For instance, by adding the following lines to `~/.bashrc`
[*server version*]
- export BOOST_ROOT=/home/user/boost_1_68_0
+ export BOOST_ROOT=/home/user/boost_1_70_0
+ export OPENSSL_ROOT_DIR=/home/user/openssl
[*GUI version*]
- export BOOST_ROOT=/home/user/boost_1_68_0
+ export BOOST_ROOT=/home/user/boost_1_70_0
+ export OPENSSL_ROOT_DIR=/home/user/openssl
export QT_PREFIX_PATH=/home/user/Qt5.11.2/5.11.2/gcc_64
-5. Building binaries
- 1. Building daemon and simplewallet:
+6. Build the binaries
+ 1. Build daemon and simplewallet:
cd zano/ && make -j1
or
@@ -88,7 +105,7 @@ For instance, by adding the following lines to `~/.bashrc`
**NOTICE 2**: If you'd like to build binaries for the testnet, use `cmake -D TESTNET=TRUE ..` instead of `cmake ..` .
- 1. Building GUI:
+ 1. Build GUI:
cd zano
utils/build_sript_linux.sh
@@ -99,9 +116,9 @@ For instance, by adding the following lines to `~/.bashrc`
### Windows
Recommended OS version: Windows 7 x64.
-1. Install required prerequisites (Boost, Qt, CMake).
+1. Install required prerequisites (Boost, Qt, CMake, OpenSSL).
2. Edit paths in `utils/configure_local_paths.cmd`.
-3. Run `utils/configure_win64_msvs2015_gui.cmd` or `utils/configure_win64_msvs2017_gui.cmd` according to your MSVC version.
+3. Run one of `utils/configure_win64_msvsNNNN_gui.cmd` according to your MSVC version.
4. Go to the build folder and open generated Zano.sln in MSVC.
5. Build.
@@ -115,7 +132,7 @@ In order to correctly deploy Qt GUI application, you also need to do the followi
### macOS
-Recommended OS version: macOS Sierra 10.15.4 x64.
+Recommended OS version: macOS Big Sur 11.4 x64.
1. Install required prerequisites.
2. Set environment variables as stated in `utils/macosx_build_config.command`.
3. `mkdir build`
`cd build`
`cmake ..`
`make`
diff --git a/contrib/CMakeLists.txt b/contrib/CMakeLists.txt
index 779876a1..601672d5 100644
--- a/contrib/CMakeLists.txt
+++ b/contrib/CMakeLists.txt
@@ -5,6 +5,10 @@ add_subdirectory(zlib)
add_subdirectory(db)
add_subdirectory(ethereum)
+if( NOT DISABLE_TOR)
+ add_subdirectory(tor-connect)
+endif()
+
if(CMAKE_SYSTEM_NAME STREQUAL "iOS" OR CMAKE_SYSTEM_NAME STREQUAL "Android")
message("excluded upnp support for IOS build")
@@ -17,6 +21,10 @@ set_property(TARGET libminiupnpc-static PROPERTY FOLDER "contrib")
set_property(TARGET zlibstatic PROPERTY FOLDER "contrib")
set_property(TARGET mdbx PROPERTY FOLDER "contrib")
set_property(TARGET lmdb PROPERTY FOLDER "contrib")
+if( NOT DISABLE_TOR)
+ set_property(TARGET tor-connect PROPERTY FOLDER "contrib")
+endif()
+
set_property(TARGET upnpc-static mdbx_chk mdbx_copy mdbx_dump mdbx_load mdbx_stat PROPERTY FOLDER "unused")
if(MSVC)
diff --git a/contrib/db/libmdbx b/contrib/db/libmdbx
deleted file mode 160000
index b7ed6754..00000000
--- a/contrib/db/libmdbx
+++ /dev/null
@@ -1 +0,0 @@
-Subproject commit b7ed67543fefb0878dba1c70dea2a81201041314
diff --git a/contrib/db/libmdbx/.circleci/config.yml b/contrib/db/libmdbx/.circleci/config.yml
new file mode 100644
index 00000000..91e11a4b
--- /dev/null
+++ b/contrib/db/libmdbx/.circleci/config.yml
@@ -0,0 +1,20 @@
+version: 2
+jobs:
+ build:
+ docker:
+ - image: circleci/buildpack-deps:artful
+ environment:
+ - TESTDB: /tmp/test.db
+ - TESTLOG: /tmp/test.log
+ steps:
+ - checkout
+ - run: make all
+ - run: ulimit -c unlimited && make check
+ - run:
+ command: |
+ mkdir -p /tmp/artifacts
+ mv -t /tmp/artifacts $TESTLOG $TESTDB core.*
+ when: on_fail
+ - store_artifacts:
+ path: /tmp/artifacts
+ destination: test-artifacts
diff --git a/contrib/db/libmdbx/.clang-format b/contrib/db/libmdbx/.clang-format
new file mode 100644
index 00000000..6c59ef3a
--- /dev/null
+++ b/contrib/db/libmdbx/.clang-format
@@ -0,0 +1,3 @@
+BasedOnStyle: LLVM
+Standard: Cpp11
+ReflowComments: true
diff --git a/contrib/db/libmdbx/.gitignore b/contrib/db/libmdbx/.gitignore
new file mode 100644
index 00000000..0496b621
--- /dev/null
+++ b/contrib/db/libmdbx/.gitignore
@@ -0,0 +1,35 @@
+*.[ao]
+*.bak
+*.exe
+*.gcda
+*.gcno
+*.gcov
+*.lo
+*.orig
+*.rej
+*.so
+*[~#]
+.idea
+.le.ini
+.vs/
+cmake-build-*
+@*
+core
+mdbx_example
+libmdbx.creator.user
+mdbx_chk
+mdbx_copy
+mdbx_dump
+mdbx_load
+mdbx_stat
+mdbx_test
+test.log
+test/tmp.db
+test/tmp.db-lck
+tmp.db
+tmp.db-lck
+valgrind.*
+src/elements/version.c
+src/elements/config.h
+dist/
+*.tar*
diff --git a/contrib/db/libmdbx/.travis.yml b/contrib/db/libmdbx/.travis.yml
new file mode 100644
index 00000000..7b468ad7
--- /dev/null
+++ b/contrib/db/libmdbx/.travis.yml
@@ -0,0 +1,61 @@
+language: c cpp
+
+matrix:
+ include:
+ - os: linux
+ dist: precise
+ env: CC=cc CXX=c++
+ - os: linux
+ dist: trusty
+ compiler: clang
+ env: CC=clang CXX=clang++
+ - os: linux
+ dist: xenial
+ compiler: gcc
+ env: CC=gcc CXX=g++
+ - os: linux
+ dist: bionic
+ compiler: clang
+ env: CC=clang CXX=clang++
+ - os: osx
+ osx_image: xcode11
+ env: CC=cc CXX=c++
+ - os: osx
+ osx_image: xcode9.4
+ env: CC=cc CXX=c++
+
+script: >
+ if [ "${COVERITY_SCAN_BRANCH}" != 1 ]; then
+ git fetch --unshallow --tags --prune &&
+ git submodule foreach --recursive git fetch --unshallow --tags --prune &&
+ (if which clang-format-6.0 > /dev/null && make reformat && [[ -n $(git diff) ]];
+ then
+ echo "You must run 'make reformat' before submitting a pull request";
+ echo "";
+ git diff;
+ exit -1;
+ fi) &&
+ make --keep-going all && MALLOC_CHECK_=7 MALLOC_PERTURB_=42 make --keep-going check
+ else
+ [ ! -s cov-int/scm_log.txt ] || cat cov-int/scm_log.txt;
+ fi && sleep 3
+
+env:
+ global:
+ - secure: "M+W+heGGyRQJoBq2W0uqWVrpL4KBXmL0MFL7FSs7f9vmAaDyEgziUXeZRj3GOKzW4kTef3LpIeiu9SmvqSMoQivGGiomZShqPVl045o/OUgRCAT7Al1RLzEZ0efSHpIPf0PZ6byEf6GR2ML76OfuL6JxTVdnz8iVyO2sgLE1HbX1VeB+wgd/jfMeOBhCCXskfK6MLyZihfMYsiYZYSaV98ZDhDLSlzuuRIgzb0bMi8aL6AErs0WLW0NelRBeHkKPYfAUc85pdQHscgrJw6Rh/zT6+8BQ/q5f4IgWhiu4xoRg3Ngl7SNoedRQh93ADM3UG2iGl6HDFpVORaXcFWKAtuYY+kHQ0HB84BRYpQmeBuXNpltsfxQ3d1Q3u0RlE45zRvmr2+X1mFnkcNUAWISLPbsOUlriDQM8irGwRpho77/uYnRC00bJsHW//s6+uPf9zrAw1nI4f0y3PAWukGF/xs6HAI3FZPsuSSnx18Tj3Opgbc9Spop+V3hkhdiJoPGpNKTkFX4ZRXfkPgoRVJmtp4PpbpH0Ps/mCriKjMEfGGi0HcVCi0pEGLXiecdqJ5KPg5+22zNycEujQBJcNTKd9shN+R3glrbmhAxTEzGdGwxXXJ2ybwJ2PWJLMYZ7g98nLyX+uQPaA3BlsbYJHNeS5283/9pJsd9DzfHKsN2nFSc="
+
+before_install:
+ - echo -n | openssl s_client -connect scan.coverity.com:443 | sed -ne '/-BEGIN CERTIFICATE-/,/-END CERTIFICATE-/p' | sudo tee -a /etc/ssl/certs/ca-
+ - ${CC} --version
+ - ${CXX} --version
+
+addons:
+ coverity_scan:
+ project:
+ name: "ReOpen/libmdbx"
+ version: 0.1
+ description: "Build submitted via Travis CI"
+ notification_email: leo@yuriev.ru
+ build_command_prepend: "git fetch --unshallow --tags --prune && make dist"
+ build_command: "make MDBX_OPTIONS=-DMDBX_DEBUG=2 -C dist all"
+ branch_pattern: coverity_scan
diff --git a/contrib/db/libmdbx/AUTHORS b/contrib/db/libmdbx/AUTHORS
new file mode 100644
index 00000000..10910e57
--- /dev/null
+++ b/contrib/db/libmdbx/AUTHORS
@@ -0,0 +1,32 @@
+Contributors
+============
+
+Alexey Naumov
+Chris Mikkelson
+Claude Brisson
+David Barbour
+David Wilson
+dreamsxin
+Hallvard Furuseth ,
+Heiko Becker
+Howard Chu ,
+Ignacio Casal Quinteiro
+James Rouzier
+Jean-Christophe DUBOIS
+John Hewson
+Klaus Malorny
+Kurt Zeilenga
+Leonid Yuriev ,
+Lorenz Bauer
+Luke Yeager
+Martin Hedenfalk
+Ondrej Kuznik
+Orivej Desh
+Oskari Timperi
+Pavel Medvedev
+Philipp Storz
+Quanah Gibson-Mount
+Salvador Ortiz
+Sebastien Launay
+Vladimir Romanov
+Zano Foundation
diff --git a/contrib/db/libmdbx/CMakeLists.dist-minimal b/contrib/db/libmdbx/CMakeLists.dist-minimal
new file mode 100644
index 00000000..1f138af6
--- /dev/null
+++ b/contrib/db/libmdbx/CMakeLists.dist-minimal
@@ -0,0 +1,192 @@
+##
+## This is the minimal template for CMakeList.txt which could be used
+## to build libmdbx from the "amalgamated form" of libmdbx's source code.
+##
+## The amalgamated form is intended to embedding libmdbx in other projects
+## in cases when using as git-submodule is not acceptable or inconveniently.
+##
+## The amalgamated form could be generated from full git repository
+## on Linux just by `make dist`.
+##
+
+##
+## Copyright 2019 Leonid Yuriev
+## and other libmdbx authors: please see AUTHORS file.
+## All rights reserved.
+##
+## Redistribution and use in source and binary forms, with or without
+## modification, are permitted only as authorized by the OpenLDAP
+## Public License.
+##
+## A copy of this license is available in the file LICENSE in the
+## top-level directory of the distribution or, alternatively, at
+## .
+##
+
+##
+## libmdbx = { Revised and extended descendant of Symas LMDB. }
+## Please see README.md at https://github.com/leo-yuriev/libmdbx
+##
+## Libmdbx is superior to LMDB in terms of features and reliability,
+## not inferior in performance. libmdbx works on Linux, FreeBSD, MacOS X
+## and other systems compliant with POSIX.1-2008, but also support Windows
+## as a complementary platform.
+##
+## The next version is under active non-public development and will be
+## released as MithrilDB and libmithrildb for libraries & packages.
+## Admittedly mythical Mithril is resembling silver but being stronger and
+## lighter than steel. Therefore MithrilDB is rightly relevant name.
+##
+## MithrilDB will be radically different from libmdbx by the new database
+## format and API based on C++17, as well as the Apache 2.0 License.
+## The goal of this revolution is to provide a clearer and robust API,
+## add more features and new valuable properties of database.
+##
+## The Future will (be) Positive. Всё будет хорошо.
+##
+
+cmake_minimum_required(VERSION 3.8.2)
+cmake_policy(PUSH)
+cmake_policy(VERSION 3.8.2)
+if(NOT CMAKE_VERSION VERSION_LESS 3.9)
+ cmake_policy(SET CMP0069 NEW)
+endif()
+if(NOT CMAKE_VERSION VERSION_LESS 3.12)
+ cmake_policy(SET CMP0075 NEW)
+endif()
+if(NOT CMAKE_VERSION VERSION_LESS 3.13)
+ cmake_policy(SET CMP0077 NEW)
+endif()
+
+if(DEFINED PROJECT_NAME)
+ set(SUBPROJECT ON)
+ set(NOT_SUBPROJECT OFF)
+else()
+ set(SUBPROJECT OFF)
+ set(NOT_SUBPROJECT ON)
+ project(libmdbx C CXX)
+endif()
+
+find_package(Threads REQUIRED)
+
+if(NOT CMAKE_BUILD_TYPE)
+ set(CMAKE_BUILD_TYPE MinSizeRel CACHE STRING
+ "Choose the type of build, options are: Debug Release RelWithDebInfo MinSizeRel."
+ FORCE)
+endif()
+
+list(FIND CMAKE_C_COMPILE_FEATURES c_std_11 HAS_C11)
+if(NOT HAS_C11 LESS 0)
+ set(MDBX_C_STANDARD 11)
+else()
+ set(MDBX_C_STANDARD 99)
+endif()
+message(STATUS "Use C${MDBX_C_STANDARD} for libmdbx")
+
+# not supported by this (minimal) script
+add_definitions(-DMDBX_AVOID_CRT=0)
+
+# provide build timestamp
+string(TIMESTAMP MDBX_BUILD_TIMESTAMP UTC)
+add_definitions(-DMDBX_BUILD_TIMESTAMP="${MDBX_BUILD_TIMESTAMP}")
+
+# provide compiler info
+execute_process(COMMAND sh -c "${CMAKE_C_COMPILER} --version | head -1"
+ OUTPUT_VARIABLE MDBX_BUILD_COMPILER
+ OUTPUT_STRIP_TRAILING_WHITESPACE
+ ERROR_QUIET
+ RESULT_VARIABLE rc)
+if(rc OR NOT MDBX_BUILD_COMPILER)
+ string(STRIP "${CMAKE_C_COMPILER_ID}-${CMAKE_C_COMPILER_VERSION}" MDBX_BUILD_COMPILER)
+endif()
+add_definitions(-DMDBX_BUILD_COMPILER="${MDBX_BUILD_COMPILER}")
+
+# provide cpu/arch-system pair
+if(CMAKE_C_COMPILER_TARGET)
+ set(MDBX_BUILD_TARGET "${CMAKE_C_COMPILER_TARGET}")
+elseif(CMAKE_C_PLATFORM_ID AND NOT CMAKE_C_PLATFORM_ID STREQUAL CMAKE_SYSTEM_NAME)
+ string(STRIP "${CMAKE_C_PLATFORM_ID}-${CMAKE_SYSTEM_NAME}" MDBX_BUILD_TARGET)
+elseif(CMAKE_LIBRARY_ARCHITECTURE)
+ string(STRIP "${CMAKE_LIBRARY_ARCHITECTURE}-${CMAKE_SYSTEM_NAME}" MDBX_BUILD_TARGET)
+elseif(CMAKE_GENERATOR_PLATFORM AND NOT CMAKE_C_PLATFORM_ID STREQUAL CMAKE_SYSTEM_NAME)
+ string(STRIP "${CMAKE_GENERATOR_PLATFORM}-${CMAKE_SYSTEM_NAME}" MDBX_BUILD_TARGET)
+elseif(CMAKE_SYSTEM_ARCH)
+ string(STRIP "${CMAKE_SYSTEM_ARCH}-${CMAKE_SYSTEM_NAME}" MDBX_BUILD_TARGET)
+else()
+ string(STRIP "${CMAKE_SYSTEM_PROCESSOR}-${CMAKE_SYSTEM_NAME}" MDBX_BUILD_TARGET)
+endif()
+add_definitions(-DMDBX_BUILD_TARGET="${MDBX_BUILD_TARGET}")
+
+# provide build target-config
+if(CMAKE_CONFIGURATION_TYPES)
+ add_definitions(-DMDBX_BUILD_CONFIG="$")
+else()
+ add_definitions(-DMDBX_BUILD_CONFIG="${CMAKE_BUILD_TYPE}")
+endif()
+
+# provide build cflags
+set(MDBX_BUILD_FLAGS "")
+list(APPEND MDBX_BUILD_FLAGS ${CMAKE_C_FLAGS})
+list(APPEND MDBX_BUILD_FLAGS ${CMAKE_C_DEFINES})
+if(CMAKE_CONFIGURATION_TYPES)
+ add_definitions(-DMDBX_BUILD_FLAGS_CONFIG="$<$:${CMAKE_C_FLAGS_DEBUG} ${CMAKE_C_DEFINES_DEBUG}>$<$:${CMAKE_C_FLAGS_RELEASE} ${CMAKE_C_DEFINES_RELEASE}>$<$:${CMAKE_C_FLAGS_RELWITHDEBINFO} ${CMAKE_C_DEFINES_RELWITHDEBINFO}>$<$:${CMAKE_C_FLAGS_MINSIZEREL} ${CMAKE_C_DEFINES_MINSIZEREL}>")
+else()
+ string(TOUPPER ${CMAKE_BUILD_TYPE} CMAKE_BUILD_TYPE_UPPERCASE)
+ list(APPEND MDBX_BUILD_FLAGS ${CMAKE_C_FLAGS_${CMAKE_BUILD_TYPE_UPPERCASE}})
+ list(APPEND MDBX_BUILD_FLAGS ${CMAKE_C_DEFINES_${CMAKE_BUILD_TYPE_UPPERCASE}})
+endif()
+list(REMOVE_DUPLICATES MDBX_BUILD_FLAGS)
+string(REPLACE ";" " " MDBX_BUILD_FLAGS "${MDBX_BUILD_FLAGS}")
+add_definitions(-DMDBX_BUILD_FLAGS="${MDBX_BUILD_FLAGS}")
+
+# shared library
+if(NOT DEFINED MDBX_BUILD_SHARED_LIBRARY)
+ if(DEFINED BUILD_SHARED_LIBS)
+ option(MDBX_BUILD_SHARED_LIBRARY "Build libmdbx as shared library (DLL)" ${BUILD_SHARED_LIBS})
+ else()
+ option(MDBX_BUILD_SHARED_LIBRARY "Build libmdbx as shared library (DLL)" ON)
+ endif()
+endif()
+if(MDBX_BUILD_SHARED_LIBRARY)
+ add_library(mdbx SHARED mdbx.c mdbx.h)
+ set_target_properties(mdbx PROPERTIES
+ C_STANDARD ${MDBX_C_STANDARD} C_STANDARD_REQUIRED ON
+ PUBLIC_HEADER mdbx.h)
+ target_compile_definitions(mdbx PRIVATE LIBMDBX_EXPORTS INTERFACE LIBMDBX_IMPORTS)
+ if(DEFINED INTERPROCEDURAL_OPTIMIZATION)
+ set_target_properties(mdbx PROPERTIES
+ INTERPROCEDURAL_OPTIMIZATION $)
+ endif()
+ target_link_libraries(mdbx PRIVATE ${CMAKE_THREAD_LIBS_INIT})
+ if(WIN32)
+ target_link_libraries(mdbx PRIVATE ntdll.lib)
+ endif()
+endif()
+
+# static library used for tools, to avoid rpath/dll-path troubles
+add_library(mdbx-static STATIC EXCLUDE_FROM_ALL mdbx.c mdbx.h)
+set_target_properties(mdbx-static PROPERTIES
+ C_STANDARD ${MDBX_C_STANDARD} C_STANDARD_REQUIRED ON
+ PUBLIC_HEADER mdbx.h)
+target_link_libraries(mdbx-static INTERFACE ${CMAKE_THREAD_LIBS_INIT})
+if(DEFINED INTERPROCEDURAL_OPTIMIZATION)
+ set_target_properties(mdbx-static PROPERTIES
+ INTERPROCEDURAL_OPTIMIZATION $)
+endif()
+if(WIN32)
+ target_link_libraries(mdbx-static INTERFACE ntdll.lib)
+endif()
+
+# mdbx-tools
+foreach(TOOL mdbx_chk mdbx_copy mdbx_stat mdbx_dump mdbx_load)
+ add_executable(${TOOL} ${TOOL}.c)
+ set_target_properties(${TOOL} PROPERTIES
+ C_STANDARD ${MDBX_C_STANDARD} C_STANDARD_REQUIRED ON)
+ if(DEFINED INTERPROCEDURAL_OPTIMIZATION)
+ set_target_properties(${TOOL} PROPERTIES
+ INTERPROCEDURAL_OPTIMIZATION $)
+ endif()
+ target_link_libraries(${TOOL} mdbx-static)
+endforeach()
+
+cmake_policy(POP)
diff --git a/contrib/db/libmdbx/CMakeLists.txt b/contrib/db/libmdbx/CMakeLists.txt
new file mode 100644
index 00000000..75e9b3b0
--- /dev/null
+++ b/contrib/db/libmdbx/CMakeLists.txt
@@ -0,0 +1,342 @@
+##
+## Copyright 2019 Leonid Yuriev
+## and other libmdbx authors: please see AUTHORS file.
+## All rights reserved.
+##
+## Redistribution and use in source and binary forms, with or without
+## modification, are permitted only as authorized by the OpenLDAP
+## Public License.
+##
+## A copy of this license is available in the file LICENSE in the
+## top-level directory of the distribution or, alternatively, at
+## .
+##
+
+##
+## libmdbx = { Revised and extended descendant of Symas LMDB. }
+## Please see README.md at https://github.com/leo-yuriev/libmdbx
+##
+## Libmdbx is superior to LMDB in terms of features and reliability,
+## not inferior in performance. libmdbx works on Linux, FreeBSD, MacOS X
+## and other systems compliant with POSIX.1-2008, but also support Windows
+## as a complementary platform.
+##
+## The next version is under active non-public development and will be
+## released as MithrilDB and libmithrildb for libraries & packages.
+## Admittedly mythical Mithril is resembling silver but being stronger and
+## lighter than steel. Therefore MithrilDB is rightly relevant name.
+##
+## MithrilDB will be radically different from libmdbx by the new database
+## format and API based on C++17, as well as the Apache 2.0 License.
+## The goal of this revolution is to provide a clearer and robust API,
+## add more features and new valuable properties of database.
+##
+## The Future will (be) Positive. Всё будет хорошо.
+##
+
+cmake_minimum_required(VERSION 3.8.2)
+cmake_policy(PUSH)
+cmake_policy(VERSION 3.8.2)
+if(NOT CMAKE_VERSION VERSION_LESS 3.13)
+ cmake_policy(SET CMP0077 NEW)
+endif()
+if(NOT CMAKE_VERSION VERSION_LESS 3.12)
+ cmake_policy(SET CMP0075 NEW)
+endif()
+if(NOT CMAKE_VERSION VERSION_LESS 3.9)
+ cmake_policy(SET CMP0069 NEW)
+ include(CheckIPOSupported)
+ check_ipo_supported(RESULT CMAKE_INTERPROCEDURAL_OPTIMIZATION_AVAILABLE)
+else()
+ set(CMAKE_INTERPROCEDURAL_OPTIMIZATION_AVAILABLE FALSE)
+endif()
+
+if(DEFINED PROJECT_NAME)
+ set(SUBPROJECT ON)
+ set(NOT_SUBPROJECT OFF)
+ if(NOT DEFINED BUILD_TESTING)
+ set(BUILD_TESTING OFF)
+ endif()
+else()
+ set(SUBPROJECT OFF)
+ set(NOT_SUBPROJECT ON)
+ project(libmdbx C CXX)
+ if(NOT DEFINED BUILD_TESTING)
+ set(BUILD_TESTING ON)
+ endif()
+endif()
+
+if(NOT CMAKE_BUILD_TYPE)
+ set(CMAKE_BUILD_TYPE MinSizeRel CACHE STRING
+ "Choose the type of build, options are: Debug Release RelWithDebInfo MinSizeRel."
+ FORCE)
+endif()
+
+macro(add_mdbx_option NAME DESCRIPTION DEFAULT)
+ list(APPEND MDBX_BUILD_OPTIONS ${NAME})
+ if(NOT ${DEFAULT} STREQUAL "AUTO")
+ option(${NAME} "${DESCRIPTION}" ${DEFAULT})
+ endif()
+endmacro()
+
+# only for compatibility testing
+# set(CMAKE_CXX_STANDARD 14)
+
+if(NOT "$ENV{TEAMCITY_PROCESS_FLOW_ID}" STREQUAL "")
+ set(CI TEAMCITY)
+ message(STATUS "TeamCity CI")
+elseif(NOT "$ENV{TRAVIS}" STREQUAL "")
+ set(CI TRAVIS)
+ message(STATUS "Travis CI")
+elseif(NOT "$ENV{CIRCLECI}" STREQUAL "")
+ set(CI CIRCLE)
+ message(STATUS "Circle CI")
+elseif(NOT "$ENV{APPVEYOR}" STREQUAL "")
+ set(CI APPVEYOR)
+ message(STATUS "AppVeyor CI")
+elseif(NOT "$ENV{CI}" STREQUAL "")
+ set(CI "$ENV{CI}")
+ message(STATUS "Other CI (${CI})")
+else()
+ message(STATUS "Assume No any CI environment")
+ unset(CI)
+endif()
+
+# output all mdbx-related targets in single directory
+if(NOT DEFINED MDBX_OUTPUT_DIR)
+ set(MDBX_OUTPUT_DIR ${CMAKE_CURRENT_BINARY_DIR})
+endif()
+set(CMAKE_ARCHIVE_OUTPUT_DIRECTORY ${MDBX_OUTPUT_DIR})
+set(CMAKE_LIBRARY_OUTPUT_DIRECTORY ${MDBX_OUTPUT_DIR})
+set(CMAKE_PDB_OUTPUT_DIRECTORY ${MDBX_OUTPUT_DIR})
+set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${MDBX_OUTPUT_DIR})
+
+include(CheckLibraryExists)
+include(CheckIncludeFiles)
+include(CheckCCompilerFlag)
+include(CheckSymbolExists)
+include(CheckCSourceRuns)
+include(CheckCXXSourceRuns)
+include(CheckCSourceCompiles)
+include(CheckCXXSourceCompiles)
+include(TestBigEndian)
+include(CheckFunctionExists)
+include(FindPackageMessage)
+include(CheckStructHasMember)
+include(CMakeDependentOption)
+include(GNUInstallDirs)
+
+if(CMAKE_C_COMPILER_ID STREQUAL "MSVC" AND MSVC_VERSION LESS 1900)
+ message(SEND_ERROR "MSVC compiler ${MSVC_VERSION} is too old for building MDBX."
+ " At least 'Microsoft Visual Studio 2015' is required.")
+endif()
+
+# Set default build type to Release. This is to ease a User's life.
+if(NOT CMAKE_BUILD_TYPE)
+ set(CMAKE_BUILD_TYPE Release CACHE STRING
+ "Choose the type of build, options are: Debug Release RelWithDebInfo MinSizeRel."
+ FORCE)
+endif()
+string(TOUPPER ${CMAKE_BUILD_TYPE} CMAKE_BUILD_TYPE_UPPERCASE)
+
+include(cmake/utils.cmake)
+include(cmake/compiler.cmake)
+include(cmake/profile.cmake)
+
+find_program(ECHO echo)
+find_program(CAT cat)
+find_program(GIT git)
+find_program(LD ld)
+
+# CHECK_INCLUDE_FILES(unistd.h HAVE_UNISTD_H)
+# CHECK_INCLUDE_FILES(sys/uio.h HAVE_SYS_UIO_H)
+# CHECK_INCLUDE_FILES(sys/stat.h HAVE_SYS_STAT_H)
+
+CHECK_FUNCTION_EXISTS(pow NOT_NEED_LIBM)
+if(NOT_NEED_LIBM)
+ set(LIB_MATH "")
+else()
+ set(CMAKE_REQUIRED_LIBRARIES m)
+ CHECK_FUNCTION_EXISTS(pow HAVE_LIBM)
+ if(HAVE_LIBM)
+ set(LIB_MATH m)
+ else()
+ message(FATAL_ERROR "No libm found for math support")
+ endif()
+endif()
+
+find_package(Threads REQUIRED)
+
+if(SUBPROJECT)
+ if(NOT DEFINED BUILD_SHARED_LIBS)
+ option(BUILD_SHARED_LIBS "Build shared libraries (DLLs)" OFF)
+ endif()
+ if(NOT DEFINED CMAKE_POSITION_INDEPENDENT_CODE)
+ option(CMAKE_POSITION_INDEPENDENT_CODE "Generate position independed (PIC)" ON)
+ endif()
+else()
+ option(BUILD_SHARED_LIBS "Build shared libraries (DLLs)" ON)
+ option(CMAKE_POSITION_INDEPENDENT_CODE "Generate position independed (PIC)" ON)
+ if (CC_HAS_ARCH_NATIVE)
+ option(BUILD_FOR_NATIVE_CPU "Generate code for the compiling machine CPU" OFF)
+ endif()
+
+ if(CMAKE_CONFIGURATION_TYPES OR NOT CMAKE_BUILD_TYPE_UPPERCASE STREQUAL "DEBUG")
+ set(INTERPROCEDURAL_OPTIMIZATION_DEFAULT ON)
+ else()
+ set(INTERPROCEDURAL_OPTIMIZATION_DEFAULT OFF)
+ endif()
+
+ if(CMAKE_INTERPROCEDURAL_OPTIMIZATION_AVAILABLE
+ OR GCC_LTO_AVAILABLE OR MSVC_LTO_AVAILABLE OR CLANG_LTO_AVAILABLE)
+ option(INTERPROCEDURAL_OPTIMIZATION "Enable interprocedural/LTO optimization" ${INTERPROCEDURAL_OPTIMIZATION_DEFAULT})
+ endif()
+
+ if(INTERPROCEDURAL_OPTIMIZATION)
+ if(GCC_LTO_AVAILABLE)
+ set(LTO_ENABLED TRUE)
+ set(CMAKE_AR ${CMAKE_GCC_AR} CACHE PATH "Path to ar program with LTO-plugin" FORCE)
+ set(CMAKE_NM ${CMAKE_GCC_NM} CACHE PATH "Path to nm program with LTO-plugin" FORCE)
+ set(CMAKE_RANLIB ${CMAKE_GCC_RANLIB} CACHE PATH "Path to ranlib program with LTO-plugin" FORCE)
+ message(STATUS "MDBX indulge Link-Time Optimization by GCC")
+ elseif(CLANG_LTO_AVAILABLE)
+ set(LTO_ENABLED TRUE)
+ set(CMAKE_AR ${CMAKE_CLANG_AR} CACHE PATH "Path to ar program with LTO-plugin" FORCE)
+ set(CMAKE_NM ${CMAKE_CLANG_NM} CACHE PATH "Path to nm program with LTO-plugin" FORCE)
+ set(CMAKE_RANLIB ${CMAKE_CLANG_RANLIB} CACHE PATH "Path to ranlib program with LTO-plugin" FORCE)
+ message(STATUS "MDBX indulge Link-Time Optimization by CLANG")
+ elseif(MSVC_LTO_AVAILABLE)
+ set(LTO_ENABLED TRUE)
+ message(STATUS "MDBX indulge Link-Time Optimization by MSVC")
+ elseif(CMAKE_INTERPROCEDURAL_OPTIMIZATION_AVAILABLE)
+ message(STATUS "MDBX indulge Interprocedural Optimization by CMake")
+ set(CMAKE_INTERPROCEDURAL_OPTIMIZATION TRUE)
+ set(LTO_ENABLED TRUE)
+ else()
+ message(WARNING "Unable to engage interprocedural/LTO optimization.")
+ endif()
+ else()
+ set(CMAKE_INTERPROCEDURAL_OPTIMIZATION FALSE)
+ set(LTO_ENABLED FALSE)
+ endif()
+
+ find_program(VALGRIND valgrind)
+ if(VALGRIND)
+ # LY: cmake is ugly and nasty.
+ # - therefore memcheck-options should be defined before including ctest;
+ # - otherwise ctest may ignore it.
+ set(MEMORYCHECK_SUPPRESSIONS_FILE
+ "${PROJECT_SOURCE_DIR}/test/valgrind_suppress.txt"
+ CACHE FILEPATH "Suppressions file for Valgrind" FORCE)
+ set(MEMORYCHECK_COMMAND_OPTIONS
+ "--trace-children=yes --leak-check=full --track-origins=yes --error-exitcode=42 --error-markers=@ --errors-for-leak-kinds=definite --fair-sched=yes --suppressions=${MEMORYCHECK_SUPPRESSIONS_FILE}"
+ CACHE STRING "Valgrind options" FORCE)
+ set(VALGRIND_COMMAND_OPTIONS "${MEMORYCHECK_COMMAND_OPTIONS}" CACHE STRING "Valgrind options" FORCE)
+ endif()
+
+ #
+ # Enable 'make tags' target.
+ find_program(CTAGS ctags)
+ if(CTAGS)
+ add_custom_target(tags COMMAND ${CTAGS} -R -f tags
+ WORKING_DIRECTORY ${CMAKE_SOURCE_DIR})
+ add_custom_target(ctags DEPENDS tags)
+ endif(CTAGS)
+
+ #
+ # Enable 'make reformat' target.
+ find_program(CLANG_FORMAT
+ NAMES clang-format-6.0 clang-format-5.0 clang-format-4.0
+ clang-format-3.9 clang-format-3.8 clang-format-3.7 clang-format)
+ if(CLANG_FORMAT AND UNIX)
+ add_custom_target(reformat
+ VERBATIM
+ COMMAND
+ git ls-files |
+ grep -E \\.\(c|cxx|cc|cpp|h|hxx|hpp\)\(\\.in\)?\$ |
+ xargs ${CLANG_FORMAT} -i --style=file
+ WORKING_DIRECTORY ${CMAKE_SOURCE_DIR})
+ endif()
+
+ if(NOT "${PROJECT_BINARY_DIR}" STREQUAL "${PROJECT_SOURCE_DIR}")
+ add_custom_target(distclean)
+ add_custom_command(TARGET distclean
+ COMMAND ${CMAKE_COMMAND} -E remove_directory "${PROJECT_BINARY_DIR}"
+ COMMENT "Removing the build directory and its content")
+ elseif(IS_DIRECTORY .git AND GIT)
+ add_custom_target(distclean)
+ add_custom_command(TARGET distclean
+ WORKING_DIRECTORY ${PROJECT_SOURCE_DIR}
+ COMMAND ${GIT} submodule foreach --recursive git clean -f -X -d
+ COMMAND ${GIT} clean -f -X -d
+ COMMENT "Removing all build files from the source directory")
+ endif()
+
+ setup_compile_flags()
+endif(SUBPROJECT)
+
+list(FIND CMAKE_C_COMPILE_FEATURES c_std_11 HAS_C11)
+if(NOT HAS_C11 LESS 0)
+ set(MDBX_C_STANDARD 11)
+else()
+ set(MDBX_C_STANDARD 99)
+endif()
+message(STATUS "Use C${MDBX_C_STANDARD} for libmdbx")
+
+##############################################################################
+##############################################################################
+#
+# #### ##### ##### # #### # # ####
+# # # # # # # # # ## # #
+# # # # # # # # # # # # ####
+# # # ##### # # # # # # # #
+# # # # # # # # # ## # #
+# #### # # # #### # # ####
+#
+
+set(MDBX_BUILD_OPTIONS ENABLE_ASAN MDBX_USE_VALGRIND ENABLE_GPROF ENABLE_GCOV)
+add_mdbx_option(MDBX_BUILD_SHARED_LIBRARY "Build libmdbx as shared library (DLL)" ${BUILD_SHARED_LIBS})
+add_mdbx_option(MDBX_ALLOY_BUILD "Build MDBX library as single object file" ON)
+add_mdbx_option(MDBX_TXN_CHECKOWNER "Checking transaction matches the calling thread inside libmdbx's API" ON)
+add_mdbx_option(MDBX_TXN_CHECKPID "Paranoid checking PID inside libmdbx's API" AUTO)
+mark_as_advanced(MDBX_TXN_CHECKPID)
+if(${CMAKE_SYSTEM_NAME} STREQUAL "Linux")
+ add_mdbx_option(MDBX_DISABLE_GNU_SOURCE "Don't use nonstandard GNU/Linux extension functions" OFF)
+ mark_as_advanced(MDBX_DISABLE_GNU_SOURCE)
+endif()
+if(${CMAKE_SYSTEM_NAME} STREQUAL "Darwin")
+ add_mdbx_option(MDBX_OSX_SPEED_INSTEADOF_DURABILITY "Disable use fcntl(F_FULLFSYNC) in favor of speed" OFF)
+ mark_as_advanced(MDBX_OSX_SPEED_INSTEADOF_DURABILITY)
+endif()
+if(${CMAKE_SYSTEM_NAME} STREQUAL "Windows")
+ add_mdbx_option(MDBX_AVOID_CRT "Avoid dependence from MSVC CRT" ${NOT_SUBPROJECT})
+ if(NOT MDBX_BUILD_SHARED_LIBRARY)
+ add_mdbx_option(MDBX_CONFIG_MANUAL_TLS_CALLBACK
+ "Provide mdbx_dll_handler() for manual initialization" OFF)
+ mark_as_advanced(MDBX_CONFIG_MANUAL_TLS_CALLBACK)
+ endif()
+else()
+ add_mdbx_option(MDBX_USE_ROBUST "Use POSIX.1-2008 robust mutexes" AUTO)
+ mark_as_advanced(MDBX_USE_ROBUST)
+ add_mdbx_option(MDBX_USE_OFDLOCKS "Use Open file description locks (aka OFD locks, non-POSIX)" AUTO)
+ mark_as_advanced(MDBX_USE_OFDLOCKS)
+endif()
+option(MDBX_ENABLE_TESTS "Build MDBX tests." ${BUILD_TESTING})
+
+################################################################################
+################################################################################
+
+add_subdirectory(src)
+if(MDBX_ENABLE_TESTS)
+ add_subdirectory(test)
+endif()
+
+set(PACKAGE "libmdbx")
+set(CPACK_PACKAGE_VERSION_MAJOR ${MDBX_VERSION_MAJOR})
+set(CPACK_PACKAGE_VERSION_MINOR ${MDBX_VERSION_MINOR})
+set(CPACK_PACKAGE_VERSION_PATCH ${MDBX_VERSION_RELEASE})
+set(CPACK_PACKAGE_VERSION_COMMIT ${MDBX_VERSION_REVISION})
+set(PACKAGE_VERSION "${CPACK_PACKAGE_VERSION_MAJOR}.${CPACK_PACKAGE_VERSION_MINOR}.${CPACK_PACKAGE_VERSION_PATCH}.${CPACK_PACKAGE_VERSION_COMMIT}")
+message(STATUS "libmdbx package version is ${PACKAGE_VERSION}")
+
+cmake_policy(POP)
diff --git a/contrib/db/libmdbx/COPYRIGHT b/contrib/db/libmdbx/COPYRIGHT
new file mode 100644
index 00000000..46e09610
--- /dev/null
+++ b/contrib/db/libmdbx/COPYRIGHT
@@ -0,0 +1,22 @@
+Copyright 2015-2019 Leonid Yuriev .
+Copyright 2011-2015 Howard Chu, Symas Corp.
+Copyright 2015,2016 Peter-Service R&D LLC.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted only as authorized by the OpenLDAP
+Public License.
+
+A copy of this license is available in the file LICENSE in the
+top-level directory of the distribution or, alternatively, at
+.
+
+OpenLDAP is a registered trademark of the OpenLDAP Foundation.
+
+Individual files and/or contributed packages may be copyright by
+other parties and/or subject to additional restrictions.
+
+This work also contains materials derived from public sources.
+
+Additional information about OpenLDAP can be obtained at
+.
diff --git a/contrib/db/libmdbx/GNUmakefile b/contrib/db/libmdbx/GNUmakefile
new file mode 100644
index 00000000..f6d0edf7
--- /dev/null
+++ b/contrib/db/libmdbx/GNUmakefile
@@ -0,0 +1,362 @@
+# This makefile is for GNU Make, and nowadays provided
+# just for compatibility and preservation of traditions.
+# Please use CMake in case of any difficulties or problems.
+#
+# Preprocessor macros (for MDBX_OPTIONS) of interest...
+# Note that the defaults should already be correct for most platforms;
+# you should not need to change any of these. Read their descriptions
+# in README and source code if you do. There may be other macros of interest.
+SHELL := /bin/bash
+
+# install sandbox
+SANDBOX ?=
+
+# install prefixes (inside sandbox)
+prefix ?= /usr/local
+mandir ?= $(prefix)/man
+
+# lib/bin suffix for multiarch/biarch, e.g. '.x86_64'
+suffix ?=
+
+CC ?= gcc
+LD ?= ld
+MDBX_OPTIONS ?= -DNDEBUG=1
+CFLAGS ?= -Os -g3 -Wall -Werror -Wextra -Wpedantic -ffunction-sections -fPIC -fvisibility=hidden -std=gnu11 -pthread -Wno-tautological-compare
+
+# LY: '--no-as-needed,-lrt' for ability to built with modern glibc, but then run with the old
+LDFLAGS ?= $(shell $(LD) --help 2>/dev/null | grep -q -- --gc-sections && echo '-Wl,--gc-sections,-z,relro,-O1')$(shell $(LD) --help 2>/dev/null | grep -q -- -dead_strip && echo '-Wl,-dead_strip')
+EXE_LDFLAGS ?= -pthread
+
+################################################################################
+
+UNAME := $(shell uname -s 2>/dev/null || echo Unknown)
+define uname2sosuffix
+ case "$(UNAME)" in
+ Darwin*|Mach*) echo dylib;;
+ CYGWIN*|MINGW*|MSYS*|Windows*) echo dll;;
+ *) echo so;;
+ esac
+endef
+SO_SUFFIX := $(shell $(uname2sosuffix))
+
+HEADERS := mdbx.h
+LIBRARIES := libmdbx.a libmdbx.$(SO_SUFFIX)
+TOOLS := mdbx_stat mdbx_copy mdbx_dump mdbx_load mdbx_chk
+MANPAGES := mdbx_stat.1 mdbx_copy.1 mdbx_dump.1 mdbx_load.1 mdbx_chk.1
+
+.PHONY: mdbx all install clean test dist check
+
+all: $(LIBRARIES) $(TOOLS)
+
+mdbx: libmdbx.a libmdbx.$(SO_SUFFIX)
+
+tools: $(TOOLS)
+
+strip: all
+ strip libmdbx.$(SO_SUFFIX) $(TOOLS)
+
+clean:
+ rm -rf $(TOOLS) mdbx_test @* *.[ao] *.[ls]o *~ tmp.db/* \
+ *.gcov *.log *.err src/*.o test/*.o mdbx_example dist \
+ config.h src/elements/config.h src/elements/version.c *.tar*
+
+libmdbx.a: mdbx-static.o
+ $(AR) rs $@ $?
+
+libmdbx.$(SO_SUFFIX): mdbx-dylib.o
+ $(CC) $(CFLAGS) $^ -pthread -shared $(LDFLAGS) -o $@
+
+#> dist-cutoff-begin
+ifeq ($(wildcard mdbx.c),mdbx.c)
+#< dist-cutoff-end
+
+################################################################################
+# Amalgamated source code, i.e. distributed after `make dists`
+MAN_SRCDIR := man1/
+
+config.h: mdbx.c $(lastword $(MAKEFILE_LIST))
+ (echo '#define MDBX_BUILD_TIMESTAMP "$(shell date +%Y-%m-%dT%H:%M:%S%z)"' \
+ && echo '#define MDBX_BUILD_FLAGS "$(CFLAGS) $(LDFLAGS)"' \
+ && echo '#define MDBX_BUILD_COMPILER "$(shell set -o pipefail; $(CC) --version | head -1 || echo 'Please use GCC or CLANG compatible compiler')"' \
+ && echo '#define MDBX_BUILD_TARGET "$(shell set -o pipefail; LC_ALL=C $(CC) -v 2>&1 | grep -i '^Target:' | cut -d ' ' -f 2- || echo 'Please use GCC or CLANG compatible compiler')"' \
+ ) > $@
+
+mdbx-dylib.o: config.h mdbx.c $(lastword $(MAKEFILE_LIST))
+ $(CC) $(CFLAGS) $(MDBX_OPTIONS) '-DMDBX_CONFIG_H="config.h"' -DLIBMDBX_EXPORTS=1 -c mdbx.c -o $@
+
+mdbx-static.o: config.h mdbx.c $(lastword $(MAKEFILE_LIST))
+ $(CC) $(CFLAGS) $(MDBX_OPTIONS) '-DMDBX_CONFIG_H="config.h"' -ULIBMDBX_EXPORTS -c mdbx.c -o $@
+
+mdbx_%: mdbx_%.c libmdbx.a
+ $(CC) $(CFLAGS) $(MDBX_OPTIONS) '-DMDBX_CONFIG_H="config.h"' $^ $(EXE_LDFLAGS) -o $@
+
+#> dist-cutoff-begin
+else
+################################################################################
+# Plain (non-amalgamated) sources with test
+
+define uname2osal
+ case "$(UNAME)" in
+ CYGWIN*|MINGW*|MSYS*|Windows*) echo windows;;
+ *) echo unix;;
+ esac
+endef
+
+define uname2titer
+ case "$(UNAME)" in
+ Darwin*|Mach*) echo 2;;
+ *) echo 12;;
+ esac
+endef
+
+DIST_EXTRA := LICENSE README.md CMakeLists.txt GNUmakefile $(addprefix man1/, $(MANPAGES))
+DIST_SRC := mdbx.h mdbx.c $(addsuffix .c, $(TOOLS))
+
+TEST_DB ?= $(shell [ -d /dev/shm ] && echo /dev/shm || echo /tmp)/mdbx-test.db
+TEST_LOG ?= $(shell [ -d /dev/shm ] && echo /dev/shm || echo /tmp)/mdbx-test.log
+TEST_OSAL := $(shell $(uname2osal))
+TEST_ITER := $(shell $(uname2titer))
+TEST_SRC := test/osal-$(TEST_OSAL).cc $(filter-out $(wildcard test/osal-*.cc), $(wildcard test/*.cc))
+TEST_INC := $(wildcard test/*.h)
+TEST_OBJ := $(patsubst %.cc,%.o,$(TEST_SRC))
+CXX ?= g++
+CXXSTD ?= $(shell $(CXX) -std=c++27 -c test/test.cc -o /dev/null 2>/dev/null && echo -std=c++17 || echo -std=c++11)
+CXXFLAGS := $(CXXSTD) $(filter-out -std=gnu11,$(CFLAGS))
+
+MAN_SRCDIR := src/man1/
+ALLOY_DEPS := $(wildcard src/elements/*)
+MDBX_VERSION_GIT = ${shell set -o pipefail; git describe --tags | sed -n 's|^v*\([0-9]\{1,\}\.[0-9]\{1,\}\.[0-9]\{1,\}\)\(.*\)|\1|p' || echo 'Please fetch tags and/or install latest git version'}
+MDBX_GIT_TIMESTAMP = $(shell git show --no-patch --format=%cI HEAD || echo 'Please install latest get version')
+MDBX_GIT_DESCRIBE = $(shell git describe --tags --long --dirty=-dirty || echo 'Please fetch tags and/or install latest git version')
+MDBX_VERSION_SUFFIX = $(shell set -o pipefail; echo -n '$(MDBX_GIT_DESCRIBE)' | tr -c -s '[a-zA-Z0-9]' _)
+MDBX_BUILD_SOURCERY = $(shell set -o pipefail; $(MAKE) -s src/elements/version.c && (openssl dgst -r -sha256 src/elements/version.c || sha256sum src/elements/version.c || shasum -a 256 src/elements/version.c) 2>/dev/null | cut -d ' ' -f 1 || echo 'Please install openssl or sha256sum or shasum')_$(MDBX_VERSION_SUFFIX)
+
+test check: all mdbx_example mdbx_test
+ rm -f $(TEST_DB) $(TEST_LOG) && (set -o pipefail; \
+ (./mdbx_test --progress --console=no --repeat=$(TEST_ITER) --pathname=$(TEST_DB) --dont-cleanup-after basic && \
+ ./mdbx_test --mode=-writemap,-lifo --progress --console=no --repeat=1 --pathname=$(TEST_DB) --dont-cleanup-after basic) \
+ | tee -a $(TEST_LOG) | tail -n 42) \
+ && ./mdbx_chk -vvn $(TEST_DB) && ./mdbx_chk -vvn $(TEST_DB)-copy
+
+mdbx_example: mdbx.h example/example-mdbx.c libmdbx.$(SO_SUFFIX)
+ $(CC) $(CFLAGS) -I. example/example-mdbx.c ./libmdbx.$(SO_SUFFIX) -o $@
+
+check-singleprocess: all mdbx_test
+ rm -f $(TEST_DB) $(TEST_LOG) && (set -o pipefail; \
+ (./mdbx_test --progress --console=no --repeat=42 --pathname=$(TEST_DB) --dont-cleanup-after --hill && \
+ ./mdbx_test --progress --console=no --repeat=2 --pathname=$(TEST_DB) --dont-cleanup-before --dont-cleanup-after --copy && \
+ ./mdbx_test --mode=-writemap,-lifo --progress --console=no --repeat=42 --pathname=$(TEST_DB) --dont-cleanup-after --nested) \
+ | tee -a $(TEST_LOG) | tail -n 42) \
+ && ./mdbx_chk -vvn $(TEST_DB) && ./mdbx_chk -vvn $(TEST_DB)-copy
+
+check-fault: all mdbx_test
+ rm -f $(TEST_DB) $(TEST_LOG) && (set -o pipefail; ./mdbx_test --progress --console=no --pathname=$(TEST_DB) --inject-writefault=42 --dump-config --dont-cleanup-after basic | tee -a $(TEST_LOG) | tail -n 42) \
+ ; ./mdbx_chk -vvnw $(TEST_DB) && ([ ! -e $(TEST_DB)-copy ] || ./mdbx_chk -vvn $(TEST_DB)-copy)
+
+VALGRIND=valgrind --trace-children=yes --log-file=valgrind-%p.log --leak-check=full --track-origins=yes --error-exitcode=42 --suppressions=test/valgrind_suppress.txt
+memcheck check-valgrind: all mdbx_test
+ @echo "$(MDBX_OPTIONS)" | grep -q MDBX_USE_VALGRIND || echo "WARNING: Please build libmdbx with -DMDBX_USE_VALGRIND to avoid false-positives from Valgrind !!!" >&2
+ rm -f valgrind-*.log $(TEST_DB) $(TEST_LOG) && (set -o pipefail; \
+ ($(VALGRIND) ./mdbx_test --mode=-writemap,-lifo --progress --console=no --repeat=4 --pathname=$(TEST_DB) --dont-cleanup-after basic && \
+ $(VALGRIND) ./mdbx_test --progress --console=no --pathname=$(TEST_DB) --dont-cleanup-before --dont-cleanup-after --copy && \
+ $(VALGRIND) ./mdbx_test --progress --console=no --repeat=2 --pathname=$(TEST_DB) --dont-cleanup-after basic) \
+ | tee -a $(TEST_LOG) | tail -n 42) \
+ && $(VALGRIND) ./mdbx_chk -vvn $(TEST_DB) && ./mdbx_chk -vvn $(TEST_DB)-copy
+
+define test-rule
+$(patsubst %.cc,%.o,$(1)): $(1) $(TEST_INC) mdbx.h $(lastword $(MAKEFILE_LIST))
+ $(CXX) $(CXXFLAGS) $(MDBX_OPTIONS) -c $(1) -o $$@
+
+endef
+$(foreach file,$(TEST_SRC),$(eval $(call test-rule,$(file))))
+
+mdbx_%: src/tools/mdbx_%.c libmdbx.a
+ $(CC) $(CFLAGS) $(MDBX_OPTIONS) '-DMDBX_CONFIG_H="config.h"' $^ $(EXE_LDFLAGS) -o $@
+
+mdbx_test: $(TEST_OBJ) libmdbx.$(SO_SUFFIX)
+ $(CXX) $(CXXFLAGS) $(TEST_OBJ) -Wl,-rpath . -L . -l mdbx $(EXE_LDFLAGS) -o $@
+
+git_DIR := $(shell if [ -d .git ]; then echo .git; elif [ -s .git -a -f .git ]; then grep '^gitdir: ' .git | cut -d ':' -f 2; else echo "Please use libmdbx as a git-submodule or the amalgamated source code" >&2 && echo git_directory; fi)
+
+src/elements/version.c: src/elements/version.c.in $(lastword $(MAKEFILE_LIST)) $(git_DIR)/HEAD $(git_DIR)/index $(git_DIR)/refs/tags
+ sed \
+ -e "s|@MDBX_GIT_TIMESTAMP@|$(MDBX_GIT_TIMESTAMP)|" \
+ -e "s|@MDBX_GIT_TREE@|$(shell git show --no-patch --format=%T HEAD || echo 'Please install latest get version')|" \
+ -e "s|@MDBX_GIT_COMMIT@|$(shell git show --no-patch --format=%H HEAD || echo 'Please install latest get version')|" \
+ -e "s|@MDBX_GIT_DESCRIBE@|$(MDBX_GIT_DESCRIBE)|" \
+ -e "s|\$${MDBX_VERSION_MAJOR}|$(shell echo '$(MDBX_VERSION_GIT)' | cut -d . -f 1)|" \
+ -e "s|\$${MDBX_VERSION_MINOR}|$(shell echo '$(MDBX_VERSION_GIT)' | cut -d . -f 2)|" \
+ -e "s|\$${MDBX_VERSION_RELEASE}|$(shell echo '$(MDBX_VERSION_GIT)' | cut -d . -f 3)|" \
+ -e "s|\$${MDBX_VERSION_REVISION}|$(shell git rev-list --count --no-merges HEAD || echo 'Please fetch tags and/or install latest git version')|" \
+ src/elements/version.c.in > $@
+
+src/elements/config.h: src/elements/version.c $(lastword $(MAKEFILE_LIST))
+ (echo '#define MDBX_BUILD_TIMESTAMP "$(shell date +%Y-%m-%dT%H:%M:%S%z)"' \
+ && echo '#define MDBX_BUILD_FLAGS "$(CFLAGS) $(LDFLAGS)"' \
+ && echo '#define MDBX_BUILD_COMPILER "$(shell set -o pipefail; $(CC) --version | head -1 || echo 'Please use GCC or CLANG compatible compiler')"' \
+ && echo '#define MDBX_BUILD_TARGET "$(shell set -o pipefail; LC_ALL=C $(CC) -v 2>&1 | grep -i '^Target:' | cut -d ' ' -f 2- || echo 'Please use GCC or CLANG compatible compiler')"' \
+ && echo '#define MDBX_BUILD_SOURCERY $(MDBX_BUILD_SOURCERY)' \
+ ) > $@
+
+mdbx-dylib.o: src/elements/config.h src/elements/version.c src/alloy.c $(ALLOY_DEPS) $(lastword $(MAKEFILE_LIST))
+ $(CC) $(CFLAGS) $(MDBX_OPTIONS) '-DMDBX_CONFIG_H="config.h"' -DLIBMDBX_EXPORTS=1 -c src/alloy.c -o $@
+
+mdbx-static.o: src/elements/config.h src/elements/version.c src/alloy.c $(ALLOY_DEPS) $(lastword $(MAKEFILE_LIST))
+ $(CC) $(CFLAGS) $(MDBX_OPTIONS) '-DMDBX_CONFIG_H="config.h"' -ULIBMDBX_EXPORTS -c src/alloy.c -o $@
+
+.PHONY: dist
+dist: libmdbx-sources-$(MDBX_VERSION_SUFFIX).tar.gz $(lastword $(MAKEFILE_LIST))
+
+libmdbx-sources-$(MDBX_VERSION_SUFFIX).tar.gz: $(addprefix dist/, $(DIST_SRC) $(DIST_EXTRA)) $(addprefix dist/man1/,$(MANPAGES))
+ tar -c -a -f $@ --owner=0 --group=0 -C dist $(DIST_SRC) $(DIST_EXTRA) \
+ && rm dist/@tmp-shared_internals.inc
+
+dist/mdbx.h: mdbx.h src/elements/version.c $(lastword $(MAKEFILE_LIST))
+ mkdir -p dist && cp $< $@
+
+dist/GNUmakefile: GNUmakefile
+ mkdir -p dist && sed -e '/^#> dist-cutoff-begin/,/^#< dist-cutoff-end/d' $< > $@
+
+dist/@tmp-shared_internals.inc: src/elements/version.c $(ALLOY_DEPS) $(lastword $(MAKEFILE_LIST))
+ mkdir -p dist && sed \
+ -e 's|#pragma once|#define MDBX_ALLOY 1\n#define MDBX_BUILD_SOURCERY $(MDBX_BUILD_SOURCERY)|' \
+ -e 's|#include "../../mdbx.h"|@INCLUDE "mdbx.h"|' \
+ -e '/#include "defs.h"/r src/elements/defs.h' \
+ -e '/#include "osal.h"/r src/elements/osal.h' \
+ src/elements/internals.h > $@
+
+dist/mdbx.c: dist/@tmp-shared_internals.inc $(lastword $(MAKEFILE_LIST))
+ mkdir -p dist && (cat dist/@tmp-shared_internals.inc \
+ && cat src/elements/core.c src/elements/osal.c src/elements/version.c \
+ && echo '#if defined(_WIN32) || defined(_WIN64)' \
+ && cat src/elements/lck-windows.c && echo '#else /* LCK-implementation */' \
+ && cat src/elements/lck-posix.c && echo '#endif /* LCK-implementation */' \
+ ) | grep -v -e '#include "' -e '#pragma once' | sed 's|@INCLUDE|#include|' > $@
+
+define dist-tool-rule
+dist/$(1).c: src/tools/$(1).c src/tools/wingetopt.h src/tools/wingetopt.c \
+ dist/@tmp-shared_internals.inc $(lastword $(MAKEFILE_LIST))
+ mkdir -p dist && sed \
+ -e '/#include "..\/elements\/internals.h"/r dist/@tmp-shared_internals.inc' \
+ -e '/#include "wingetopt.h"/r src/tools/wingetopt.c' \
+ src/tools/$(1).c \
+ | grep -v -e '#include "' -e '#pragma once' -e '#define MDBX_ALLOY' \
+ | sed 's|@INCLUDE|#include|' > $$@
+
+endef
+$(foreach file,$(TOOLS),$(eval $(call dist-tool-rule,$(file))))
+
+dist/man1/mdbx_%.1: src/man1/mdbx_%.1
+ mkdir -p dist/man1/ && cp $< $@
+dist/LICENSE: LICENSE
+ mkdir -p dist/man1/ && cp $< $@
+dist/README.md: README.md
+ mkdir -p dist/man1/ && cp $< $@
+dist/CMakeLists.txt: CMakeLists.dist-minimal
+ mkdir -p dist/man1/ && cp $< $@
+endif
+
+################################################################################
+# Cross-compilation simple test
+
+CROSS_LIST = mips-linux-gnu-gcc \
+ powerpc64-linux-gnu-gcc powerpc-linux-gnu-gcc \
+ arm-linux-gnueabihf-gcc aarch64-linux-gnu-gcc \
+ sh4-linux-gnu-gcc mips64-linux-gnuabi64-gcc
+
+# hppa-linux-gnu-gcc - don't supported by current qemu release
+# s390x-linux-gnu-gcc - qemu troubles (hang/abort)
+# sparc64-linux-gnu-gcc - qemu troubles (fcntl for F_SETLK/F_GETLK)
+# alpha-linux-gnu-gcc - qemu (or gcc) troubles (coredump)
+
+CROSS_LIST_NOQEMU = hppa-linux-gnu-gcc s390x-linux-gnu-gcc \
+ sparc64-linux-gnu-gcc alpha-linux-gnu-gcc
+
+cross-gcc:
+ @echo "CORRESPONDING CROSS-COMPILERs ARE REQUIRED."
+ @echo "FOR INSTANCE: apt install g++-aarch64-linux-gnu g++-alpha-linux-gnu g++-arm-linux-gnueabihf g++-hppa-linux-gnu g++-mips-linux-gnu g++-mips64-linux-gnuabi64 g++-powerpc-linux-gnu g++-powerpc64-linux-gnu g++-s390x-linux-gnu g++-sh4-linux-gnu g++-sparc64-linux-gnu"
+ @for CC in $(CROSS_LIST_NOQEMU) $(CROSS_LIST); do \
+ echo "===================== $$CC"; \
+ $(MAKE) clean && CC=$$CC CXX=$$(echo $$CC | sed 's/-gcc/-g++/') EXE_LDFLAGS=-static $(MAKE) all || exit $$?; \
+ done
+
+# Unfortunately qemu don't provide robust support for futexes.
+# Therefore it is impossible to run full multi-process tests.
+cross-qemu:
+ @echo "CORRESPONDING CROSS-COMPILERs AND QEMUs ARE REQUIRED."
+ @echo "FOR INSTANCE: "
+ @echo " 1) apt install g++-aarch64-linux-gnu g++-alpha-linux-gnu g++-arm-linux-gnueabihf g++-hppa-linux-gnu g++-mips-linux-gnu g++-mips64-linux-gnuabi64 g++-powerpc-linux-gnu g++-powerpc64-linux-gnu g++-s390x-linux-gnu g++-sh4-linux-gnu g++-sparc64-linux-gnu"
+ @echo " 2) apt install binfmt-support qemu-user-static qemu-user qemu-system-arm qemu-system-mips qemu-system-misc qemu-system-ppc qemu-system-sparc"
+ @for CC in $(CROSS_LIST); do \
+ echo "===================== $$CC + qemu"; \
+ $(MAKE) clean && \
+ CC=$$CC CXX=$$(echo $$CC | sed 's/-gcc/-g++/') EXE_LDFLAGS=-static MDBX_OPTIONS="-DMDBX_SAFE4QEMU $(MDBX_OPTIONS)" \
+ $(MAKE) check-singleprocess || exit $$?; \
+ done
+
+#< dist-cutoff-end
+install: $(LIBRARIES) $(TOOLS) $(HEADERS)
+ mkdir -p $(SANDBOX)$(prefix)/bin$(suffix) \
+ && cp -t $(SANDBOX)$(prefix)/bin$(suffix) $(TOOLS) && \
+ mkdir -p $(SANDBOX)$(prefix)/lib$(suffix) \
+ && cp -t $(SANDBOX)$(prefix)/lib$(suffix) $(LIBRARIES) && \
+ mkdir -p $(SANDBOX)$(prefix)/include \
+ && cp -t $(SANDBOX)$(prefix)/include $(HEADERS) && \
+ mkdir -p $(SANDBOX)$(mandir)/man1 \
+ && cp -t $(SANDBOX)$(mandir)/man1 $(addprefix $(MAN_SRCDIR), $(MANPAGES))
+
+################################################################################
+# Benchmarking by ioarena
+
+IOARENA ?= $(shell \
+ (test -x ../ioarena/@BUILD/src/ioarena && echo ../ioarena/@BUILD/src/ioarena) || \
+ (test -x ../../@BUILD/src/ioarena && echo ../../@BUILD/src/ioarena) || \
+ (test -x ../../src/ioarena && echo ../../src/ioarena) || which ioarena)
+NN ?= 25000000
+
+ifneq ($(wildcard $(IOARENA)),)
+
+.PHONY: bench clean-bench re-bench
+
+clean-bench:
+ rm -rf bench-*.txt _ioarena/*
+
+re-bench: clean-bench bench
+
+define bench-rule
+bench-$(1)_$(2).txt: $(3) $(IOARENA) $(lastword $(MAKEFILE_LIST))
+ LD_LIBRARY_PATH="./:$$$${LD_LIBRARY_PATH}" \
+ $(IOARENA) -D $(1) -B crud -m nosync -n $(2) \
+ | tee $$@ | grep throughput && \
+ LD_LIBRARY_PATH="./:$$$${LD_LIBRARY_PATH}" \
+ $(IOARENA) -D $(1) -B get,iterate -m sync -r 4 -n $(2) \
+ | tee -a $$@ | grep throughput \
+ || mv -f $$@ $$@.error
+
+endef
+
+$(eval $(call bench-rule,mdbx,$(NN),libmdbx.$(SO_SUFFIX)))
+
+$(eval $(call bench-rule,sophia,$(NN)))
+$(eval $(call bench-rule,leveldb,$(NN)))
+$(eval $(call bench-rule,rocksdb,$(NN)))
+$(eval $(call bench-rule,wiredtiger,$(NN)))
+$(eval $(call bench-rule,forestdb,$(NN)))
+$(eval $(call bench-rule,lmdb,$(NN)))
+$(eval $(call bench-rule,nessdb,$(NN)))
+$(eval $(call bench-rule,sqlite3,$(NN)))
+$(eval $(call bench-rule,ejdb,$(NN)))
+$(eval $(call bench-rule,vedisdb,$(NN)))
+$(eval $(call bench-rule,dummy,$(NN)))
+
+$(eval $(call bench-rule,debug,10))
+
+bench: bench-mdbx_$(NN).txt
+
+.PHONY: bench-debug
+
+bench-debug: bench-debug_10.txt
+
+bench-quartet: bench-mdbx_$(NN).txt bench-lmdb_$(NN).txt bench-rocksdb_$(NN).txt bench-wiredtiger_$(NN).txt
+
+endif
diff --git a/contrib/db/libmdbx/LICENSE b/contrib/db/libmdbx/LICENSE
new file mode 100644
index 00000000..05ad7571
--- /dev/null
+++ b/contrib/db/libmdbx/LICENSE
@@ -0,0 +1,47 @@
+The OpenLDAP Public License
+ Version 2.8, 17 August 2003
+
+Redistribution and use of this software and associated documentation
+("Software"), with or without modification, are permitted provided
+that the following conditions are met:
+
+1. Redistributions in source form must retain copyright statements
+ and notices,
+
+2. Redistributions in binary form must reproduce applicable copyright
+ statements and notices, this list of conditions, and the following
+ disclaimer in the documentation and/or other materials provided
+ with the distribution, and
+
+3. Redistributions must contain a verbatim copy of this document.
+
+The OpenLDAP Foundation may revise this license from time to time.
+Each revision is distinguished by a version number. You may use
+this Software under terms of this license revision or under the
+terms of any subsequent revision of the license.
+
+THIS SOFTWARE IS PROVIDED BY THE OPENLDAP FOUNDATION AND ITS
+CONTRIBUTORS ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
+INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT
+SHALL THE OPENLDAP FOUNDATION, ITS CONTRIBUTORS, OR THE AUTHOR(S)
+OR OWNER(S) OF THE SOFTWARE BE LIABLE FOR ANY DIRECT, INDIRECT,
+INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
+BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
+ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGE.
+
+The names of the authors and copyright holders must not be used in
+advertising or otherwise to promote the sale, use or other dealing
+in this Software without specific, written prior permission. Title
+to copyright in this Software shall at all times remain with copyright
+holders.
+
+OpenLDAP is a registered trademark of the OpenLDAP Foundation.
+
+Copyright 1999-2003 The OpenLDAP Foundation, Redwood City,
+California, USA. All Rights Reserved. Permission to copy and
+distribute verbatim copies of this document is granted.
diff --git a/contrib/db/libmdbx/README.md b/contrib/db/libmdbx/README.md
new file mode 100644
index 00000000..1e82f3f3
--- /dev/null
+++ b/contrib/db/libmdbx/README.md
@@ -0,0 +1,591 @@
+### The [repository now only mirrored on the Github](https://abf.io/erthink/libmdbx) due to illegal discriminatory restrictions for Russian Crimea and for sovereign crimeans.
+
+-----
+
+libmdbx
+======================================
+
+_libmdbx_ is an extremely fast, compact, powerful, embedded
+transactional [key-value
+store](https://en.wikipedia.org/wiki/Key-value_database)
+database, with permissive [OpenLDAP Public License](LICENSE).
+_libmdbx_ has a specific set of properties and capabilities,
+focused on creating unique lightweight solutions with
+extraordinary performance.
+
+The next version is under active non-public development and will be
+released as **_MithrilDB_** and `libmithrildb` for libraries & packages.
+Admittedly mythical [Mithril](https://en.wikipedia.org/wiki/Mithril) is
+resembling silver but being stronger and lighter than steel. Therefore
+_MithrilDB_ is rightly relevant name.
+> _MithrilDB_ will be radically different from _libmdbx_ by the new
+> database format and API based on C++17, as well as the [Apache 2.0
+> License](https://www.apache.org/licenses/LICENSE-2.0). The goal of this
+> revolution is to provide a clearer and robust API, add more features and
+> new valuable properties of database.
+
+*The Future will (be) [Positive](https://www.ptsecurity.com). Всё будет хорошо.*
+
+[](https://travis-ci.org/leo-yuriev/libmdbx)
+[](https://ci.appveyor.com/project/leo-yuriev/libmdbx/branch/master)
+[](https://scan.coverity.com/projects/reopen-libmdbx)
+
+## Table of Contents
+- [Overview](#overview)
+ - [Comparison with other databases](#comparison-with-other-databases)
+ - [History & Acknowledgments](#history)
+- [Description](#description)
+ - [Key features](#key-features)
+ - [Improvements over LMDB](#improvements-over-lmdb)
+ - [Gotchas](#gotchas)
+- [Usage](#usage)
+ - [Building](#building)
+ - [Bindings](#bindings)
+- [Performance comparison](#performance-comparison)
+ - [Integral performance](#integral-performance)
+ - [Read scalability](#read-scalability)
+ - [Sync-write mode](#sync-write-mode)
+ - [Lazy-write mode](#lazy-write-mode)
+ - [Async-write mode](#async-write-mode)
+ - [Cost comparison](#cost-comparison)
+
+-----
+
+## Overview
+
+_libmdbx_ is revised and extended descendant of amazing [Lightning
+Memory-Mapped
+Database](https://en.wikipedia.org/wiki/Lightning_Memory-Mapped_Database).
+_libmdbx_ inherits all features and characteristics from
+[LMDB](https://en.wikipedia.org/wiki/Lightning_Memory-Mapped_Database),
+but resolves some issues and adds several features.
+
+ - _libmdbx_ guarantee data integrity after crash unless this was explicitly
+neglected in favour of write performance.
+
+ - _libmdbx_ allows multiple processes to read and update several key-value
+tables concurrently, while being
+[ACID](https://en.wikipedia.org/wiki/ACID)-compliant, with minimal
+overhead and Olog(N) operation cost.
+
+ - _libmdbx_ enforce
+[serializability](https://en.wikipedia.org/wiki/Serializability) for
+writers by single
+[mutex](https://en.wikipedia.org/wiki/Mutual_exclusion) and affords
+[wait-free](https://en.wikipedia.org/wiki/Non-blocking_algorithm#Wait-freedom)
+for parallel readers without atomic/interlocked operations, while
+writing and reading transactions do not block each other.
+
+ - _libmdbx_ uses [B+Trees](https://en.wikipedia.org/wiki/B%2B_tree) and
+[Memory-Mapping](https://en.wikipedia.org/wiki/Memory-mapped_file),
+doesn't use [WAL](https://en.wikipedia.org/wiki/Write-ahead_logging)
+which might be a caveat for some workloads.
+
+ - _libmdbx_ implements a simplified variant of the [Berkeley
+DB](https://en.wikipedia.org/wiki/Berkeley_DB) and/or
+[dbm](https://en.wikipedia.org/wiki/DBM_(computing)) API.
+
+ - _libmdbx_ supports Linux, Windows, MacOS, FreeBSD and other systems
+compliant with POSIX.1-2008.
+
+### Comparison with other databases
+For now please refer to [chapter of "BoltDB comparison with other
+databases"](https://github.com/coreos/bbolt#comparison-with-other-databases)
+which is also (mostly) applicable to _libmdbx_.
+
+### History
+At first the development was carried out within the
+[ReOpenLDAP](https://github.com/leo-yuriev/ReOpenLDAP) project. About a
+year later _libmdbx_ was separated into standalone project, which was
+[presented at Highload++ 2015
+conference](http://www.highload.ru/2015/abstracts/1831.html).
+
+Since 2017 _libmdbx_ is used in [Fast Positive Tables](https://github.com/leo-yuriev/libfpta),
+and development is funded by [Positive Technologies](https://www.ptsecurity.com).
+
+### Acknowledgments
+Howard Chu is the author of LMDB, from which
+originated the MDBX in 2015.
+
+Martin Hedenfalk is the author of `btree.c` code, which
+was used for begin development of LMDB.
+
+-----
+
+Description
+===========
+
+## Key features
+
+1. Key-value pairs are stored in ordered map(s), keys are always sorted,
+range lookups are supported.
+
+2. Data is [memory-mapped](https://en.wikipedia.org/wiki/Memory-mapped_file)
+into each worker DB process, and could be accessed zero-copy from transactions.
+
+3. Transactions are
+[ACID](https://en.wikipedia.org/wiki/ACID)-compliant, through to
+[MVCC](https://en.wikipedia.org/wiki/Multiversion_concurrency_control)
+and [CoW](https://en.wikipedia.org/wiki/Copy-on-write). Writes are
+strongly serialized and aren't blocked by reads, transactions can't
+conflict with each other. Reads are guaranteed to get only commited data
+([relaxing serializability](https://en.wikipedia.org/wiki/Serializability#Relaxing_serializability)).
+
+4. Read transactions are
+[non-blocking](https://en.wikipedia.org/wiki/Non-blocking_algorithm),
+don't use [atomic operations](https://en.wikipedia.org/wiki/Linearizability#High-level_atomic_operations).
+Readers don't block each other and aren't blocked by writers. Read
+performance scales linearly with CPU core count.
+ > Nonetheless, "connect to DB" (starting the first read transaction in a thread) and
+ > "disconnect from DB" (closing DB or thread termination) requires a lock
+ > acquisition to register/unregister at the "readers table".
+
+5. Keys with multiple values are stored efficiently without key
+duplication, sorted by value, including integers (valuable for
+secondary indexes).
+
+6. Efficient operation on short fixed length keys,
+including 32/64-bit integer types.
+
+7. [WAF](https://en.wikipedia.org/wiki/Write_amplification) (Write
+Amplification Factor) и RAF (Read Amplification Factor) are Olog(N).
+
+8. No [WAL](https://en.wikipedia.org/wiki/Write-ahead_logging) and
+transaction journal. In case of a crash no recovery needed. No need for
+regular maintenance. Backups can be made on the fly on working DB
+without freezing writers.
+
+9. No additional memory management, all done by basic OS services.
+
+
+## Improvements over LMDB
+
+_libmdbx_ is superior to _legendary [LMDB](https://symas.com/lmdb/)_ in
+terms of features and reliability, not inferior in performance. In
+comparison to LMDB, _libmdbx_ make things "just work" perfectly and
+out-of-the-box, not silently and catastrophically break down. The list
+below is pruned down to the improvements most notable and obvious from
+the user's point of view.
+
+1. Automatic on-the-fly database size control by preset parameters, both
+reduction and increment.
+ > _libmdbx_ manage the database size according to parameters specified
+ > by `mdbx_env_set_geometry()` function,
+ > ones include the growth step and the truncation threshold.
+
+2. Automatic continuous zero-overhead database compactification.
+ > _libmdbx_ logically move as possible a freed pages
+ > at end of allocation area into unallocated space,
+ > and then release such space if a lot of.
+
+3. LIFO policy for recycling a Garbage Collection items. On systems with a disk
+write-back cache, this can significantly increase write performance, up to
+several times in a best case scenario.
+ > LIFO means that for reuse pages will be taken which became unused the lastest.
+ > Therefore the loop of database pages circulation becomes as short as possible.
+ > In other words, the number of pages, that are overwritten in memory
+ > and on disk during a series of write transactions, will be as small as possible.
+ > Thus creates ideal conditions for the efficient operation of the disk write-back cache.
+
+4. Fast estimation of range query result volume, i.e. how many items can
+be found between a `KEY1` and a `KEY2`. This is prerequisite for build
+and/or optimize query execution plans.
+ > _libmdbx_ performs a rough estimate based only on b-tree pages that
+ > are common for the both stacks of cursors that were set to corresponing
+ > keys.
+
+5. `mdbx_chk` tool for database integrity check.
+
+6. Guarantee of database integrity even in asynchronous unordered write-to-disk mode.
+ > _libmdbx_ propose additional trade-off by implementing append-like manner for updates
+ > in `NOSYNC` and `MAPASYNC` modes, that avoid database corruption after a system crash
+ > contrary to LMDB. Nevertheless, the `MDBX_UTTERLY_NOSYNC` mode available to match LMDB behaviour,
+ > and for a special use-cases.
+
+7. Automated steady flush to disk upon volume of changes and/or by
+timeout via cheap polling.
+
+8. Sequence generation and three cheap persistent 64-bit markers with ACID.
+
+9. Support for keys and values of zero length, including multi-values
+(aka sorted duplicates).
+
+10. The handler of lack-of-space condition with a callback,
+that allow you to control and resolve such situations.
+
+11. Support for opening a database in the exclusive mode, including on a network share.
+
+12. Extended transaction info, including dirty and leftover space info
+for a write transaction, reading lag and hold over space for read
+transactions.
+
+13. Extended whole-database info (aka environment) and reader enumeration.
+
+14. Extended update or delete, _at once_ with getting previous value
+and addressing the particular item from multi-value with the same key.
+
+15. Support for explicitly updating the existing record, not insertion a new one.
+
+16. All cursors are uniformly, can be reused and should be closed explicitly,
+regardless ones were opened within write or read transaction.
+
+17. Correct update of current record with `MDBX_CURRENT` flag when size
+of key or data was changed, including sorted duplicated.
+
+18. Opening database handles is spared from race conditions and
+pre-opening is not needed.
+
+19. Ability to determine whether the particular data is on a dirty page
+or not, that allows to avoid copy-out before updates.
+
+20. Ability to determine whether the cursor is pointed to a key-value
+pair, to the first, to the last, or not set to anything.
+
+21. Returning `MDBX_EMULTIVAL` error in case of ambiguous update or delete.
+
+22. On **MacOS** the `fcntl(F_FULLFSYNC)` syscall is used _by
+default_ to synchronize data with the disk, as this is [the only way to
+guarantee data
+durability](https://developer.apple.com/library/archive/documentation/System/Conceptual/ManPages_iPhoneOS/man2/fsync.2.html)
+in case of power failure. Unfortunately, in scenarios with high write
+intensity, the use of `F_FULLFSYNC` significant degrades performance
+compared to LMDB, where the `fsync()` syscall is used. Therefore,
+_libmdbx_ allows you to override this behavior by defining the
+`MDBX_OSX_SPEED_INSTEADOF_DURABILITY=1` option while build the library.
+
+23. On **Windows** the `LockFileEx()` syscall is used for locking, since
+it allows place the database on network drives, and provides protection
+against incompetent user actions (aka
+[poka-yoke](https://en.wikipedia.org/wiki/Poka-yoke)). Therefore
+_libmdbx_ may be a little lag in performance tests from LMDB where a
+named mutexes are used.
+
+
+## Gotchas
+
+1. There cannot be more than one writer at a time.
+ > On the other hand, this allows serialize an updates and eliminate any
+ > possibility of conflicts, deadlocks or logical errors.
+
+2. No [WAL](https://en.wikipedia.org/wiki/Write-ahead_logging) means
+relatively big [WAF](https://en.wikipedia.org/wiki/Write_amplification)
+(Write Amplification Factor). Because of this syncing data to disk might
+be quite resource intensive and be main performance bottleneck during
+intensive write workload.
+ > As compromise _libmdbx_ allows several modes of lazy and/or periodic
+ > syncing, including `MAPASYNC` mode, which modificate data in memory and
+ > asynchronously syncs data to disk, moment to sync is picked by OS.
+ >
+ > Although this should be used with care, synchronous transactions in a DB
+ > with transaction journal will require 2 IOPS minimum (probably 3-4 in
+ > practice) because of filesystem overhead, overhead depends on
+ > filesystem, not on record count or record size. In _libmdbx_ IOPS count
+ > will grow logarithmically depending on record count in DB (height of B+
+ > tree) and will require at least 2 IOPS per transaction too.
+
+3. [CoW](https://en.wikipedia.org/wiki/Copy-on-write) for
+[MVCC](https://en.wikipedia.org/wiki/Multiversion_concurrency_control)
+is done on memory page level with
+[B+trees](https://ru.wikipedia.org/wiki/B-%D0%B4%D0%B5%D1%80%D0%B5%D0%B2%D0%BE).
+Therefore altering data requires to copy about Olog(N) memory pages,
+which uses [memory bandwidth](https://en.wikipedia.org/wiki/Memory_bandwidth) and is main
+performance bottleneck in `MDBX_MAPASYNC` mode.
+ > This is unavoidable, but isn't that bad. Syncing data to disk requires
+ > much more similar operations which will be done by OS, therefore this is
+ > noticeable only if data sync to persistent storage is fully disabled.
+ > _libmdbx_ allows to safely save data to persistent storage with minimal
+ > performance overhead. If there is no need to save data to persistent
+ > storage then it's much more preferable to use `std::map`.
+
+4. Massive altering of data during a parallel long read operation will
+increase the process work set, may exhaust entire free database space and
+result in subsequent write performance degradation.
+ > _libmdbx_ mostly solve this issue by lack-of-space callback and `MDBX_LIFORECLAIM` mode.
+ > See [`mdbx.h`](mdbx.h) with API description for details.
+ > The "next" version of libmdbx (MithrilDB) will completely solve this.
+
+5. There are no built-in checksums or digests to verify database integrity.
+ > The "next" version of _libmdbx_ (MithrilDB) will solve this issue employing [Merkle Tree](https://en.wikipedia.org/wiki/Merkle_tree).
+
+--------------------------------------------------------------------------------
+
+Usage
+=====
+
+## Source code embedding
+
+_libmdbx_ provides two official ways for integration in source code form:
+
+1. Using the amalgamated source code.
+ > The amalgamated source code includes all files requires to build and
+ > use _libmdbx_, but not for testing _libmdbx_ itself.
+
+2. Adding the complete original source code as a `git submodule`.
+ > This allows you to build as _libmdbx_ and testing tool.
+ > On the other hand, this way requires you to pull git tags, and use C++11 compiler for test tool.
+
+**_Please, avoid using any other techniques._** Otherwise, at least
+don't ask for support and don't name such chimeras `libmdbx`.
+
+The amalgamated source code could be created from original clone of git
+repository on Linux by executing `make dist`. As a result, the desired
+set of files will be formed in the `dist` subdirectory.
+
+## Building
+
+Both amalgamated and original source code provides build through the use
+[CMake](https://cmake.org/) or [GNU
+Make](https://www.gnu.org/software/make/) with
+[bash](https://en.wikipedia.org/wiki/Bash_(Unix_shell)). All build ways
+are completely traditional and have minimal prerequirements like
+`build-essential`, i.e. the non-obsolete C/C++ compiler and a
+[SDK](https://en.wikipedia.org/wiki/Software_development_kit) for the
+target platform. Obviously you need building tools itself, i.e. `git`,
+`cmake` or GNU `make` with `bash`.
+
+So just use CMake or GNU Make in your habitual manner and feel free to
+fill an issue or make pull request in the case something will be
+unexpected or broken down.
+
+#### DSO/DLL unloading and destructors of Thread-Local-Storage objects
+When building _libmdbx_ as a shared library or use static _libmdbx_ as a
+part of another dynamic library, it is advisable to make sure that your
+system ensures the correctness of the call destructors of
+Thread-Local-Storage objects when unloading dynamic libraries.
+
+If this is not the case, then unloading a dynamic-link library with
+_libmdbx_ code inside, can result in either a resource leak or a crash
+due to calling destructors from an already unloaded DSO/DLL object. The
+problem can only manifest in a multithreaded application, which makes
+the unloading of shared dynamic libraries with _libmdbx_ code inside,
+after using _libmdbx_. It is known that TLS-destructors are properly
+maintained in the following cases:
+
+- On all modern versions of Windows (Windows 7 and later).
+
+- On systems with the
+[`__cxa_thread_atexit_impl()`](https://sourceware.org/glibc/wiki/Destructor%20support%20for%20thread_local%20variables)
+function in the standard C library, including systems with GNU libc
+version 2.18 and later.
+
+- On systems with libpthread/ntpl from GNU libc with bug fixes
+[#21031](https://sourceware.org/bugzilla/show_bug.cgi?id=21031) and
+[#21032](https://sourceware.org/bugzilla/show_bug.cgi?id=21032), or
+where there are no similar bugs in the pthreads implementation.
+
+### Linux and other platforms with GNU Make
+To build the library it is enough to execute `make all` in the directory
+of source code, and `make check` for execute the basic tests.
+
+If the `make` installed on the system is not GNU Make, there will be a
+lot of errors from make when trying to build. In this case, perhaps you
+should use `gmake` instead of `make`, or even `gnu-make`, etc.
+
+### FreeBSD and related platforms
+As a rule, in such systems, the default is to use Berkeley Make. And GNU
+Make is called by the gmake command or may be missing. In addition,
+[bash](https://en.wikipedia.org/wiki/Bash_(Unix_shell)) may be absent.
+
+You need to install the required components: GNU Make, bash, C and C++
+compilers compatible with GCC or CLANG. After that, to build the
+library, it is enough execute `gmake all` (or `make all`) in the
+directory with source code, and `gmake check` (or `make check`) to run
+the basic tests.
+
+### Windows
+For build _libmdbx_ on Windows the _original_ CMake and [Microsoft Visual
+Studio](https://en.wikipedia.org/wiki/Microsoft_Visual_Studio) are
+recommended.
+
+Building by MinGW, MSYS or Cygwin is potentially possible. However,
+these scripts are not tested and will probably require you to modify the
+CMakeLists.txt or Makefile respectively.
+
+It should be noted that in _libmdbx_ was efforts to resolve
+runtime dependencies from CRT and other libraries Visual Studio.
+For this is enough define the `MDBX_AVOID_CRT` during build.
+
+An example of running a basic test script can be found in the
+[CI-script](appveyor.yml) for [AppVeyor](https://www.appveyor.com/). To
+run the [long stochastic test scenario](test/long_stochastic.sh),
+[bash](https://en.wikipedia.org/wiki/Bash_(Unix_shell)) is required, and
+the such testing is recommended with place the test data on the
+[RAM-disk](https://en.wikipedia.org/wiki/RAM_drive).
+
+### MacOS
+Current [native build tools](https://en.wikipedia.org/wiki/Xcode) for
+MacOS include GNU Make, CLANG and an outdated version of bash.
+Therefore, to build the library, it is enough to run `make all` in the
+directory with source code, and run `make check` to execute the base
+tests. If something goes wrong, it is recommended to install
+[Homebrew](https://brew.sh/) and try again.
+
+To run the [long stochastic test scenario](test/long_stochastic.sh), you
+will need to install the current (not outdated) version of
+[bash](https://en.wikipedia.org/wiki/Bash_(Unix_shell)). To do this, we
+recommend that you install [Homebrew](https://brew.sh/) and then execute
+`brew install bash`.
+
+## Bindings
+
+ | Runtime | GitHub | Author |
+ | -------- | ------ | ------ |
+ | Java | [mdbxjni](https://github.com/castortech/mdbxjni) | [Castor Technologies](https://castortech.com/) |
+ | .NET | [mdbx.NET](https://github.com/wangjia184/mdbx.NET) | [Jerry Wang](https://github.com/wangjia184) |
+
+
+--------------------------------------------------------------------------------
+
+Performance comparison
+======================
+
+All benchmarks were done by [IOArena](https://github.com/pmwkaa/ioarena)
+and multiple [scripts](https://github.com/pmwkaa/ioarena/tree/HL%2B%2B2015)
+runs on Lenovo Carbon-2 laptop, i7-4600U 2.1 GHz, 8 Gb RAM,
+SSD SAMSUNG MZNTD512HAGL-000L1 (DXT23L0Q) 512 Gb.
+
+## Integral performance
+
+Here showed sum of performance metrics in 3 benchmarks:
+
+ - Read/Search on 4 CPU cores machine;
+
+ - Transactions with [CRUD](https://en.wikipedia.org/wiki/CRUD)
+ operations in sync-write mode (fdatasync is called after each
+ transaction);
+
+ - Transactions with [CRUD](https://en.wikipedia.org/wiki/CRUD)
+ operations in lazy-write mode (moment to sync data to persistent storage
+ is decided by OS).
+
+*Reasons why asynchronous mode isn't benchmarked here:*
+
+ 1. It doesn't make sense as it has to be done with DB engines, oriented
+ for keeping data in memory e.g. [Tarantool](https://tarantool.io/),
+ [Redis](https://redis.io/)), etc.
+
+ 2. Performance gap is too high to compare in any meaningful way.
+
+
+
+--------------------------------------------------------------------------------
+
+## Read Scalability
+
+Summary performance with concurrent read/search queries in 1-2-4-8
+threads on 4 CPU cores machine.
+
+
+
+--------------------------------------------------------------------------------
+
+## Sync-write mode
+
+ - Linear scale on left and dark rectangles mean arithmetic mean
+ transactions per second;
+
+ - Logarithmic scale on right is in seconds and yellow intervals mean
+ execution time of transactions. Each interval shows minimal and maximum
+ execution time, cross marks standard deviation.
+
+**10,000 transactions in sync-write mode**. In case of a crash all data
+is consistent and state is right after last successful transaction.
+[fdatasync](https://linux.die.net/man/2/fdatasync) syscall is used after
+each write transaction in this mode.
+
+In the benchmark each transaction contains combined CRUD operations (2
+inserts, 1 read, 1 update, 1 delete). Benchmark starts on empty database
+and after full run the database contains 10,000 small key-value records.
+
+
+
+--------------------------------------------------------------------------------
+
+## Lazy-write mode
+
+ - Linear scale on left and dark rectangles mean arithmetic mean of
+ thousands transactions per second;
+
+ - Logarithmic scale on right in seconds and yellow intervals mean
+ execution time of transactions. Each interval shows minimal and maximum
+ execution time, cross marks standard deviation.
+
+**100,000 transactions in lazy-write mode**. In case of a crash all data
+is consistent and state is right after one of last transactions, but
+transactions after it will be lost. Other DB engines use
+[WAL](https://en.wikipedia.org/wiki/Write-ahead_logging) or transaction
+journal for that, which in turn depends on order of operations in
+journaled filesystem. _libmdbx_ doesn't use WAL and hands I/O operations
+to filesystem and OS kernel (mmap).
+
+In the benchmark each transaction contains combined CRUD operations (2
+inserts, 1 read, 1 update, 1 delete). Benchmark starts on empty database
+and after full run the database contains 100,000 small key-value
+records.
+
+
+
+
+--------------------------------------------------------------------------------
+
+## Async-write mode
+
+ - Linear scale on left and dark rectangles mean arithmetic mean of
+ thousands transactions per second;
+
+ - Logarithmic scale on right in seconds and yellow intervals mean
+ execution time of transactions. Each interval shows minimal and maximum
+ execution time, cross marks standard deviation.
+
+**1,000,000 transactions in async-write mode**. In case of a crash all
+data will be consistent and state will be right after one of last
+transactions, but lost transaction count is much higher than in
+lazy-write mode. All DB engines in this mode do as little writes as
+possible on persistent storage. _libmdbx_ uses
+[msync(MS_ASYNC)](https://linux.die.net/man/2/msync) in this mode.
+
+In the benchmark each transaction contains combined CRUD operations (2
+inserts, 1 read, 1 update, 1 delete). Benchmark starts on empty database
+and after full run the database contains 10,000 small key-value records.
+
+
+
+--------------------------------------------------------------------------------
+
+## Cost comparison
+
+Summary of used resources during lazy-write mode benchmarks:
+
+ - Read and write IOPS;
+
+ - Sum of user CPU time and sys CPU time;
+
+ - Used space on persistent storage after the test and closed DB, but not
+ waiting for the end of all internal housekeeping operations (LSM
+ compactification, etc).
+
+_ForestDB_ is excluded because benchmark showed it's resource
+consumption for each resource (CPU, IOPS) much higher than other engines
+which prevents to meaningfully compare it with them.
+
+All benchmark data is gathered by
+[getrusage()](http://man7.org/linux/man-pages/man2/getrusage.2.html)
+syscall and by scanning data directory.
+
+
+
+--------------------------------------------------------------------------------
+
+```
+$ objdump -f -h -j .text libmdbx.so
+
+libmdbx.so: file format elf64-x86-64
+architecture: i386:x86-64, flags 0x00000150:
+HAS_SYMS, DYNAMIC, D_PAGED
+start address 0x0000000000003710
+
+Sections:
+Idx Name Size VMA LMA File off Algn
+ 11 .text 00015eff 0000000000003710 0000000000003710 00003710 2**4
+ CONTENTS, ALLOC, LOAD, READONLY, CODE
+```
diff --git a/contrib/db/libmdbx/appveyor.yml b/contrib/db/libmdbx/appveyor.yml
new file mode 100644
index 00000000..be7ee76a
--- /dev/null
+++ b/contrib/db/libmdbx/appveyor.yml
@@ -0,0 +1,99 @@
+version: 0.3.2.{build}
+
+environment:
+ matrix:
+ - APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2019
+ CMAKE_GENERATOR: Visual Studio 16 2019
+ TOOLSET: 142
+ MDBX_BUILD_SHARED_LIBRARY: OFF
+ MDBX_AVOID_CRT: OFF
+ - APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2019
+ CMAKE_GENERATOR: Visual Studio 16 2019
+ TOOLSET: 142
+ MDBX_BUILD_SHARED_LIBRARY: ON
+ MDBX_AVOID_CRT: ON
+ - APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2019
+ CMAKE_GENERATOR: Visual Studio 16 2019
+ TOOLSET: 142
+ MDBX_BUILD_SHARED_LIBRARY: OFF
+ MDBX_AVOID_CRT: ON
+ - APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2019
+ CMAKE_GENERATOR: Visual Studio 16 2019
+ TOOLSET: 142
+ MDBX_BUILD_SHARED_LIBRARY: ON
+ MDBX_AVOID_CRT: OFF
+ - APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2017
+ CMAKE_GENERATOR: Visual Studio 15 2017
+ TOOLSET: 141
+ - APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2015
+ CMAKE_GENERATOR: Visual Studio 14 2015
+ TOOLSET: 140
+
+branches:
+ except:
+ - coverity_scan
+
+configuration:
+- Debug
+- Release
+
+platform:
+- Win32
+- x64
+
+before_build:
+- git clean -x -f -d
+- git submodule sync
+- git fetch --tags --prune
+- git submodule update --init --recursive
+- git submodule foreach --recursive git fetch --tags --prune
+- cmake --version
+
+build_script:
+- ps: |
+ Write-Output "*******************************************************************************"
+ Write-Output "Configuration: $env:CONFIGURATION"
+ Write-Output "Platform: $env:PLATFORM"
+ Write-Output "Toolchain: $env:CMAKE_GENERATOR v$env:TOOLSET"
+ Write-Output "Options: MDBX_AVOID_CRT=$env:MDBX_AVOID_CRT MDBX_BUILD_SHARED_LIBRARY=$env:MDBX_BUILD_SHARED_LIBRARY"
+ Write-Output "*******************************************************************************"
+
+ md _build -Force | Out-Null
+ cd _build
+
+ $generator = $env:CMAKE_GENERATOR
+ if ($env:TOOLSET -lt 142) {
+ if ($env:PLATFORM -eq "x64") {
+ $generator = "$generator Win64"
+ }
+ & cmake -G "$generator" -D CMAKE_CONFIGURATION_TYPES="Debug;Release" -D MDBX_AVOID_CRT:BOOL=$env:MDBX_AVOID_CRT -D MDBX_BUILD_SHARED_LIBRARY:BOOL=$env:MDBX_BUILD_SHARED_LIBRARY ..
+ } else {
+ & cmake -G "$generator" -A $env:PLATFORM -D CMAKE_CONFIGURATION_TYPES="Debug;Release" -DMDBX_AVOID_CRT:BOOL=$env:MDBX_AVOID_CRT -D MDBX_BUILD_SHARED_LIBRARY:BOOL=$env:MDBX_BUILD_SHARED_LIBRARY ..
+ }
+ if ($LastExitCode -ne 0) {
+ throw "Exec: $ErrorMessage"
+ }
+ Write-Output "*******************************************************************************"
+
+ & cmake --build . --config $env:CONFIGURATION
+ if ($LastExitCode -ne 0) {
+ throw "Exec: $ErrorMessage"
+ }
+ Write-Output "*******************************************************************************"
+
+test_script:
+- ps: |
+ if (($env:PLATFORM -ne "ARM") -and ($env:PLATFORM -ne "ARM64")) {
+ & ./$env:CONFIGURATION/mdbx_test.exe --progress --console=no --pathname=test.db --dont-cleanup-after basic > test.log
+ Get-Content test.log | Select-Object -last 42
+ if ($LastExitCode -ne 0) {
+ throw "Exec: $ErrorMessage"
+ } else {
+ & ./$env:CONFIGURATION/mdbx_chk.exe -nvv test.db | Tee-Object -file chk.log | Select-Object -last 42
+ }
+ }
+
+on_failure:
+- ps: Push-AppveyorArtifact \projects\libmdbx\_build\test.log
+- ps: Push-AppveyorArtifact \projects\libmdbx\_build\test.db
+- ps: Push-AppveyorArtifact \projects\libmdbx\_build\chk.log
diff --git a/contrib/db/libmdbx/cmake/compiler.cmake b/contrib/db/libmdbx/cmake/compiler.cmake
new file mode 100644
index 00000000..03b0805b
--- /dev/null
+++ b/contrib/db/libmdbx/cmake/compiler.cmake
@@ -0,0 +1,666 @@
+## Copyright (c) 2012-2019 Leonid Yuriev .
+##
+## Licensed under the Apache License, Version 2.0 (the "License");
+## you may not use this file except in compliance with the License.
+## You may obtain a copy of the License at
+##
+## http://www.apache.org/licenses/LICENSE-2.0
+##
+## Unless required by applicable law or agreed to in writing, software
+## distributed under the License is distributed on an "AS IS" BASIS,
+## WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+## See the License for the specific language governing permissions and
+## limitations under the License.
+##
+
+cmake_minimum_required(VERSION 3.8.2)
+cmake_policy(PUSH)
+cmake_policy(VERSION 3.8.2)
+
+if (CMAKE_VERSION MATCHES ".*MSVC.*")
+ message(FATAL_ERROR "CMake from MSVC kit is unfit! "
+ "Please use the original CMake from https://cmake.org/download/")
+endif()
+
+if (NOT (CMAKE_C_COMPILER_LOADED OR CMAKE_CXX_COMPILER_LOADED))
+ message(FATAL_ERROR "This module required C or C++ to be enabled")
+endif()
+
+include(CMakeDependentOption)
+
+if(CMAKE_CXX_COMPILER_LOADED)
+ include(CheckCXXSourceRuns)
+ include(CheckCXXSourceCompiles)
+ include(CheckCXXCompilerFlag)
+endif()
+if(CMAKE_C_COMPILER_LOADED)
+ include(CheckCSourceRuns)
+ include(CheckCSourceCompiles)
+ include(CheckCCompilerFlag)
+endif()
+
+# Check if the same compile family is used for both C and CXX
+if(CMAKE_C_COMPILER_LOADED AND CMAKE_CXX_COMPILER_LOADED AND
+ NOT (CMAKE_C_COMPILER_ID STREQUAL CMAKE_CXX_COMPILER_ID))
+ message(WARNING "CMAKE_C_COMPILER_ID (${CMAKE_C_COMPILER_ID}) is different "
+ "from CMAKE_CXX_COMPILER_ID (${CMAKE_CXX_COMPILER_ID}). "
+ "The final binary may be unusable.")
+endif()
+
+if(CMAKE_CXX_COMPILER_LOADED)
+ set(CMAKE_PRIMARY_LANG "CXX")
+else()
+ set(CMAKE_PRIMARY_LANG "C")
+endif()
+
+macro(check_compiler_flag flag variable)
+ if(CMAKE_CXX_COMPILER_LOADED)
+ check_cxx_compiler_flag(${flag} ${variable})
+ else()
+ check_c_compiler_flag(${flag} ${variable})
+ endif()
+endmacro(check_compiler_flag)
+
+# We support building with Clang and gcc. First check
+# what we're using for build.
+if(CMAKE_C_COMPILER_LOADED AND CMAKE_C_COMPILER_ID STREQUAL "Clang")
+ set(CMAKE_COMPILER_IS_CLANG ON)
+ set(CMAKE_COMPILER_IS_GNUCC OFF)
+endif()
+if(CMAKE_CXX_COMPILER_LOADED AND CMAKE_CXx_COMPILER_ID STREQUAL "Clang")
+ set(CMAKE_COMPILER_IS_CLANG ON)
+ set(CMAKE_COMPILER_IS_GNUCXX OFF)
+endif()
+
+# Hard coding the compiler version is ugly from cmake POV, but
+# at least gives user a friendly error message. The most critical
+# demand for C++ compiler is support of C++11 lambdas, added
+# only in version 4.5 https://gcc.gnu.org/projects/cxx0x.html
+if(CMAKE_COMPILER_IS_GNUCC)
+ if(CMAKE_C_COMPILER_VERSION VERSION_LESS 4.5)
+ message(FATAL_ERROR "
+ Your GCC version is ${CMAKE_C_COMPILER_VERSION}, please update")
+ endif()
+endif()
+if(CMAKE_COMPILER_IS_GNUCXX)
+ if(CMAKE_CXX_COMPILER_VERSION VERSION_LESS 4.5)
+ message(FATAL_ERROR "
+ Your G++ version is ${CMAKE_CXX_COMPILER_VERSION}, please update")
+ endif()
+endif()
+
+if(CMAKE_C_COMPILER_LOADED)
+ # Check for Elbrus lcc
+ execute_process(COMMAND ${CMAKE_C_COMPILER} --version
+ OUTPUT_VARIABLE tmp_lcc_probe_version
+ RESULT_VARIABLE tmp_lcc_probe_result ERROR_QUIET)
+ if(tmp_lcc_probe_result EQUAL 0)
+ string(FIND "${tmp_lcc_probe_version}" "lcc:" tmp_lcc_marker)
+ string(FIND "${tmp_lcc_probe_version}" ":e2k-" tmp_e2k_marker)
+ if(tmp_lcc_marker GREATER -1 AND tmp_e2k_marker GREATER tmp_lcc_marker)
+ execute_process(COMMAND ${CMAKE_C_COMPILER} -print-version
+ OUTPUT_VARIABLE CMAKE_C_COMPILER_VERSION
+ RESULT_VARIABLE tmp_lcc_probe_result)
+ set(CMAKE_COMPILER_IS_ELBRUSC ON)
+ set(CMAKE_C_COMPILER_ID "Elbrus")
+ else()
+ set(CMAKE_COMPILER_IS_ELBRUSC OFF)
+ endif()
+ unset(tmp_lcc_marker)
+ unset(tmp_e2k_marker)
+ endif()
+ unset(tmp_lcc_probe_version)
+ unset(tmp_lcc_probe_result)
+endif()
+
+if(CMAKE_CXX_COMPILER_LOADED)
+ # Check for Elbrus l++
+ execute_process(COMMAND ${CMAKE_CXX_COMPILER} --version
+ OUTPUT_VARIABLE tmp_lxx_probe_version
+ RESULT_VARIABLE tmp_lxx_probe_result ERROR_QUIET)
+ if(tmp_lxx_probe_result EQUAL 0)
+ string(FIND "${tmp_lxx_probe_version}" "lcc:" tmp_lcc_marker)
+ string(FIND "${tmp_lxx_probe_version}" ":e2k-" tmp_e2k_marker)
+ if(tmp_lcc_marker GREATER -1 AND tmp_e2k_marker GREATER tmp_lcc_marker)
+ execute_process(COMMAND ${CMAKE_CXX_COMPILER} -print-version
+ OUTPUT_VARIABLE CMAKE_CXX_COMPILER_VERSION
+ RESULT_VARIABLE tmp_lxx_probe_result)
+ set(CMAKE_COMPILER_IS_ELBRUSCXX ON)
+ set(CMAKE_CXX_COMPILER_ID "Elbrus")
+ else()
+ set(CMAKE_COMPILER_IS_ELBRUSCXX OFF)
+ endif()
+ unset(tmp_lcc_marker)
+ unset(tmp_e2k_marker)
+ endif()
+ unset(tmp_lxx_probe_version)
+ unset(tmp_lxx_probe_result)
+endif()
+
+if(CMAKE_CL_64)
+ set(MSVC64 1)
+endif()
+if(WIN32 AND CMAKE_COMPILER_IS_GNU${CMAKE_PRIMARY_LANG})
+ execute_process(COMMAND ${CMAKE_${CMAKE_PRIMARY_LANG}_COMPILER} -dumpmachine
+ OUTPUT_VARIABLE __GCC_TARGET_MACHINE
+ OUTPUT_STRIP_TRAILING_WHITESPACE)
+ if(__GCC_TARGET_MACHINE MATCHES "amd64|x86_64|AMD64")
+ set(MINGW64 1)
+ endif()
+ unset(__GCC_TARGET_MACHINE)
+endif()
+
+if(CMAKE_COMPILER_IS_ELBRUSC OR CMAKE_SYSTEM_PROCESSOR MATCHES "e2k.*|E2K.*|elbrus.*|ELBRUS.*")
+ set(E2K TRUE)
+ set(CMAKE_SYSTEM_ARCH "Elbrus")
+elseif((MSVC64 OR MINGW64) AND CMAKE_SIZEOF_VOID_P EQUAL 8)
+ set(X86_64 TRUE)
+ set(CMAKE_SYSTEM_ARCH "x86_64")
+elseif(MINGW OR (MSVC AND NOT CMAKE_CROSSCOMPILING))
+ set(X86_32 TRUE)
+ set(CMAKE_SYSTEM_ARCH "x86")
+elseif(CMAKE_COMPILER_IS_ELBRUSC OR CMAKE_SYSTEM_PROCESSOR MATCHES "e2k.*|E2K.*|elbrus.*|ELBRUS.*")
+ set(E2K TRUE)
+ set(CMAKE_SYSTEM_ARCH "Elbrus")
+elseif(CMAKE_SYSTEM_PROCESSOR MATCHES "amd64.*|x86_64.*|AMD64.*" AND CMAKE_SIZEOF_VOID_P EQUAL 8)
+ set(X86_64 TRUE)
+ set(CMAKE_SYSTEM_ARCH "x86_64")
+elseif(CMAKE_SYSTEM_PROCESSOR MATCHES "i686.*|i386.*|x86.*")
+ set(X86_32 TRUE)
+ set(CMAKE_SYSTEM_ARCH "x86")
+elseif(CMAKE_SYSTEM_PROCESSOR MATCHES "^(aarch64.*|AARCH64.*|ARM64.*)" AND CMAKE_SIZEOF_VOID_P EQUAL 8)
+ set(AARCH64 TRUE)
+ set(CMAKE_SYSTEM_ARCH "ARM64")
+elseif(CMAKE_SYSTEM_PROCESSOR MATCHES "^(arm.*|ARM.*)")
+ set(ARM32 TRUE)
+ set(CMAKE_SYSTEM_ARCH "ARM")
+elseif(CMAKE_SYSTEM_PROCESSOR MATCHES "^(powerpc|ppc)64le.*" AND CMAKE_SIZEOF_VOID_P EQUAL 8)
+ set(PPC64LE TRUE)
+ set(CMAKE_SYSTEM_ARCH "PPC64LE")
+elseif(CMAKE_SYSTEM_PROCESSOR MATCHES "^(powerpc|ppc)64.*" AND CMAKE_SIZEOF_VOID_P EQUAL 8)
+ set(PPC64 TRUE)
+ set(CMAKE_SYSTEM_ARCH "PPC64")
+elseif(CMAKE_SYSTEM_PROCESSOR MATCHES "^(powerpc|ppc).*")
+ set(PPC32 TRUE)
+ set(CMAKE_SYSTEM_ARCH "PPC")
+elseif(CMAKE_SYSTEM_PROCESSOR MATCHES "^(mips|MIPS)64.*" AND CMAKE_SIZEOF_VOID_P EQUAL 8)
+ set(MIPS64 TRUE)
+ set(CMAKE_SYSTEM_ARCH "MIPS64")
+elseif(CMAKE_SYSTEM_PROCESSOR MATCHES "^(mips|MIPS).*")
+ set(MIPS32 TRUE)
+ set(CMAKE_SYSTEM_ARCH "MIPS")
+endif()
+
+if(MSVC)
+ check_compiler_flag("/WX" CC_HAS_WERROR)
+else()
+ #
+ # GCC started to warn for unused result starting from 4.2, and
+ # this is when it introduced -Wno-unused-result
+ # GCC can also be built on top of llvm runtime (on mac).
+ check_compiler_flag("-Wno-unknown-pragmas" CC_HAS_WNO_UNKNOWN_PRAGMAS)
+ check_compiler_flag("-Wextra" CC_HAS_WEXTRA)
+ check_compiler_flag("-Werror" CC_HAS_WERROR)
+ check_compiler_flag("-fexceptions" CC_HAS_FEXCEPTIONS)
+ check_cxx_compiler_flag("-fcxx-exceptions" CC_HAS_FCXX_EXCEPTIONS)
+ check_compiler_flag("-funwind-tables" CC_HAS_FUNWIND_TABLES)
+ check_compiler_flag("-fno-omit-frame-pointer" CC_HAS_FNO_OMIT_FRAME_POINTER)
+ check_compiler_flag("-fno-common" CC_HAS_FNO_COMMON)
+ check_compiler_flag("-ggdb" CC_HAS_GGDB)
+ check_compiler_flag("-fvisibility=hidden" CC_HAS_VISIBILITY)
+ check_compiler_flag("-march=native" CC_HAS_ARCH_NATIVE)
+ check_compiler_flag("-Og" CC_HAS_DEBUG_FRENDLY_OPTIMIZATION)
+ check_compiler_flag("-Wall" CC_HAS_WALL)
+ check_compiler_flag("-Ominimal" CC_HAS_OMINIMAL)
+ check_compiler_flag("-ffunction-sections -fdata-sections" CC_HAS_SECTIONS)
+ check_compiler_flag("-ffast-math" CC_HAS_FASTMATH)
+
+ # Check for an omp support
+ set(CMAKE_REQUIRED_FLAGS "-fopenmp -Werror")
+ check_cxx_source_compiles("int main(void) {
+ #pragma omp parallel
+ return 0;
+ }" HAVE_OPENMP)
+ set(CMAKE_REQUIRED_FLAGS "")
+endif()
+
+# Check for LTO support by GCC
+if(CMAKE_COMPILER_IS_GNU${CMAKE_PRIMARY_LANG})
+ unset(gcc_collect)
+ unset(gcc_lto_wrapper)
+
+ if(NOT CMAKE_${CMAKE_PRIMARY_LANG}_COMPILER_VERSION VERSION_LESS 4.7)
+ execute_process(COMMAND ${CMAKE_${CMAKE_PRIMARY_LANG}_COMPILER} -v
+ OUTPUT_VARIABLE gcc_info_v ERROR_VARIABLE gcc_info_v)
+
+ string(REGEX MATCH "^(.+\nCOLLECT_GCC=)([^ \n]+)(\n.+)$" gcc_collect_valid ${gcc_info_v})
+ if(gcc_collect_valid)
+ string(REGEX REPLACE "^(.+\nCOLLECT_GCC=)([^ \n]+)(\n.+)$" "\\2" gcc_collect ${gcc_info_v})
+ endif()
+
+ string(REGEX MATCH "^(.+\nCOLLECT_LTO_WRAPPER=)([^ \n]+/lto-wrapper)(\n.+)$" gcc_lto_wrapper_valid ${gcc_info_v})
+ if(gcc_lto_wrapper_valid)
+ string(REGEX REPLACE "^(.+\nCOLLECT_LTO_WRAPPER=)([^ \n]+/lto-wrapper)(\n.+)$" "\\2" gcc_lto_wrapper ${gcc_info_v})
+ endif()
+
+ set(gcc_suffix "")
+ if(gcc_collect_valid AND gcc_collect)
+ string(REGEX MATCH "^(.*cc)(-.+)$" gcc_suffix_valid ${gcc_collect})
+ if(gcc_suffix_valid)
+ string(REGEX MATCH "^(.*cc)(-.+)$" "\\2" gcc_suffix ${gcc_collect})
+ endif()
+ endif()
+
+ get_filename_component(gcc_dir ${CMAKE_${CMAKE_PRIMARY_LANG}_COMPILER} DIRECTORY)
+ if(NOT CMAKE_GCC_AR)
+ find_program(CMAKE_GCC_AR NAMES gcc${gcc_suffix}-ar gcc-ar${gcc_suffix} PATHS ${gcc_dir} NO_DEFAULT_PATH)
+ endif()
+ if(NOT CMAKE_GCC_NM)
+ find_program(CMAKE_GCC_NM NAMES gcc${gcc_suffix}-nm gcc-nm${gcc_suffix} PATHS ${gcc_dir} NO_DEFAULT_PATH)
+ endif()
+ if(NOT CMAKE_GCC_RANLIB)
+ find_program(CMAKE_GCC_RANLIB NAMES gcc${gcc_suffix}-ranlib gcc-ranlib${gcc_suffix} PATHS ${gcc_dir} NO_DEFAULT_PATH)
+ endif()
+
+ unset(gcc_dir)
+ unset(gcc_suffix_valid)
+ unset(gcc_suffix)
+ unset(gcc_lto_wrapper_valid)
+ unset(gcc_collect_valid)
+ unset(gcc_collect)
+ unset(gcc_info_v)
+ endif()
+
+ if(CMAKE_GCC_AR AND CMAKE_GCC_NM AND CMAKE_GCC_RANLIB AND gcc_lto_wrapper)
+ message(STATUS "Found GCC's LTO toolset: ${gcc_lto_wrapper}, ${CMAKE_GCC_AR}, ${CMAKE_GCC_RANLIB}")
+ set(GCC_LTO_CFLAGS "-flto -fno-fat-lto-objects -fuse-linker-plugin")
+ set(GCC_LTO_AVAILABLE TRUE)
+ message(STATUS "Link-Time Optimization by GCC is available")
+ else()
+ set(GCC_LTO_AVAILABLE FALSE)
+ message(STATUS "Link-Time Optimization by GCC is NOT available")
+ endif()
+ unset(gcc_lto_wrapper)
+endif()
+
+# check for LTO by MSVC
+if(MSVC)
+ if(NOT MSVC_VERSION LESS 1600)
+ set(MSVC_LTO_AVAILABLE TRUE)
+ message(STATUS "Link-Time Optimization by MSVC is available")
+ else()
+ set(MSVC_LTO_AVAILABLE FALSE)
+ message(STATUS "Link-Time Optimization by MSVC is NOT available")
+ endif()
+endif()
+
+# Check for LTO support by CLANG
+if(CMAKE_COMPILER_IS_CLANG)
+ if(NOT CMAKE_${CMAKE_PRIMARY_LANG}_COMPILER_VERSION VERSION_LESS 3.5)
+ execute_process(COMMAND ${CMAKE_${CMAKE_PRIMARY_LANG}_COMPILER} -print-search-dirs
+ OUTPUT_VARIABLE clang_search_dirs)
+
+ unset(clang_bindir)
+ unset(clang_libdir)
+ string(REGEX MATCH "^(.*programs: =)([^:]*:)*([^:]+/llvm[-.0-9]+/bin[^:]*)(:[^:]*)*(\n.+)$" clang_bindir_valid ${clang_search_dirs})
+ if(clang_bindir_valid)
+ string(REGEX REPLACE "^(.*programs: =)([^:]*:)*([^:]+/llvm[-.0-9]+/bin[^:]*)(:[^:]*)*(\n.+)$" "\\3" clang_bindir ${clang_search_dirs})
+ get_filename_component(clang_libdir "${clang_bindir}/../lib" REALPATH)
+ if(clang_libdir)
+ message(STATUS "Found CLANG/LLVM directories: ${clang_bindir}, ${clang_libdir}")
+ endif()
+ endif()
+
+ if(NOT (clang_bindir AND clang_libdir))
+ message(STATUS "Could NOT find CLANG/LLVM directories (bin and/or lib).")
+ endif()
+
+ if(NOT CMAKE_CLANG_LD AND clang_bindir)
+ find_program(CMAKE_CLANG_LD NAMES llvm-link link llvm-ld ld PATHS ${clang_bindir} NO_DEFAULT_PATH)
+ endif()
+ if(NOT CMAKE_CLANG_AR AND clang_bindir)
+ find_program(CMAKE_CLANG_AR NAMES llvm-ar ar PATHS ${clang_bindir} NO_DEFAULT_PATH)
+ endif()
+ if(NOT CMAKE_CLANG_NM AND clang_bindir)
+ find_program(CMAKE_CLANG_NM NAMES llvm-nm nm PATHS ${clang_bindir} NO_DEFAULT_PATH)
+ endif()
+ if(NOT CMAKE_CLANG_RANLIB AND clang_bindir)
+ find_program(CMAKE_CLANG_RANLIB NAMES llvm-ranlib ranlib PATHS ${clang_bindir} NO_DEFAULT_PATH)
+ endif()
+
+ set(clang_lto_plugin_name "LLVMgold${CMAKE_SHARED_LIBRARY_SUFFIX}")
+ if(NOT CMAKE_LD_GOLD AND clang_bindir)
+ find_program(CMAKE_LD_GOLD NAMES ld.gold PATHS)
+ endif()
+ if(NOT CLANG_LTO_PLUGIN AND clang_libdir)
+ find_file(CLANG_LTO_PLUGIN ${clang_lto_plugin_name} PATH ${clang_libdir} NO_DEFAULT_PATH)
+ endif()
+ if(CLANG_LTO_PLUGIN)
+ message(STATUS "Found CLANG/LLVM's plugin for LTO: ${CLANG_LTO_PLUGIN}")
+ else()
+ message(STATUS "Could NOT find CLANG/LLVM's plugin (${clang_lto_plugin_name}) for LTO.")
+ endif()
+
+ if(CMAKE_CLANG_LD AND CMAKE_CLANG_AR AND CMAKE_CLANG_NM AND CMAKE_CLANG_RANLIB)
+ message(STATUS "Found CLANG/LLVM's binutils for LTO: ${CMAKE_CLANG_AR}, ${CMAKE_CLANG_RANLIB}")
+ else()
+ message(STATUS "Could NOT find CLANG/LLVM's binutils (ar, ranlib, nm) for LTO.")
+ endif()
+
+ unset(clang_lto_plugin_name)
+ unset(clang_libdir)
+ unset(clang_bindir_valid)
+ unset(clang_bindir)
+ unset(clang_search_dirs)
+ endif()
+
+ if((CLANG_LTO_PLUGIN AND CMAKE_LD_GOLD) AND
+ (CMAKE_CLANG_LD AND CMAKE_CLANG_AR AND CMAKE_CLANG_NM AND CMAKE_CLANG_RANLIB))
+ set(CLANG_LTO_AVAILABLE TRUE)
+ message(STATUS "Link-Time Optimization by CLANG/LLVM is available")
+ elseif(CMAKE_TOOLCHAIN_FILE AND NOT CMAKE_${CMAKE_PRIMARY_LANG}_COMPILER_VERSION VERSION_LESS 7.0)
+ set(CLANG_LTO_AVAILABLE TRUE)
+ if (NOT CMAKE_CLANG_AR)
+ set(CMAKE_CLANG_AR ${CMAKE_AR})
+ endif()
+ if (NOT CMAKE_CLANG_NM)
+ set(CMAKE_CLANG_NM ${CMAKE_NM})
+ endif()
+ if (NOT CMAKE_CLANG_RANLIB)
+ set(CMAKE_CLANG_RANLIB ${CMAKE_RANLIB })
+ endif()
+ message(STATUS "Assume Link-Time Optimization by CLANG/LLVM is available via ${CMAKE_TOOLCHAIN_FILE}")
+ else()
+ set(CLANG_LTO_AVAILABLE FALSE)
+ message(STATUS "Link-Time Optimization by CLANG/LLVM is NOT available")
+ endif()
+endif()
+
+# Perform build type specific configuration.
+option(ENABLE_BACKTRACE "Enable output of fiber backtrace information in 'show
+ fiber' administrative command. Only works on x86 architectures, if compiled
+ with gcc. If GNU binutils and binutils-dev libraries are installed, backtrace
+ is output with resolved function (symbol) names. Otherwise only frame
+ addresses are printed." OFF)
+
+set(HAVE_BFD False)
+if(ENABLE_BACKTRACE)
+ if(NOT (X86_32 OR X86_64) OR NOT CMAKE_COMPILER_IS_GNU${CMAKE_PRIMARY_LANG})
+ # We only know this option to work with gcc
+ message(FATAL_ERROR "ENABLE_BACKTRACE option is set but the system
+ is not x86 based (${CMAKE_SYSTEM_PROCESSOR}) or the compiler
+ is not GNU GCC (${CMAKE_${CMAKE_PRIMARY_LANG}_COMPILER}).")
+ endif()
+ # Use GNU bfd if present.
+ find_library(BFD_LIBRARY NAMES libbfd.a)
+ if(BFD_LIBRARY)
+ check_library_exists(${BFD_LIBRARY} bfd_init "" HAVE_BFD_LIB)
+ endif()
+ find_library(IBERTY_LIBRARY NAMES libiberty.a)
+ if(IBERTY_LIBRARY)
+ check_library_exists(${IBERTY_LIBRARY} cplus_demangle "" HAVE_IBERTY_LIB)
+ endif()
+ set(CMAKE_REQUIRED_DEFINITIONS -DPACKAGE=${PACKAGE} -DPACKAGE_VERSION=${PACKAGE_VERSION})
+ check_include_files(bfd.h HAVE_BFD_H)
+ set(CMAKE_REQUIRED_DEFINITIONS)
+ find_package(ZLIB)
+ if(HAVE_BFD_LIB AND HAVE_BFD_H AND HAVE_IBERTY_LIB AND ZLIB_FOUND)
+ set(HAVE_BFD ON)
+ set(BFD_LIBRARIES ${BFD_LIBRARY} ${IBERTY_LIBRARY} ${ZLIB_LIBRARIES})
+ find_package_message(BFD_LIBRARIES "Found libbfd and dependencies"
+ ${BFD_LIBRARIES})
+ if(TARGET_OS_FREEBSD AND NOT TARGET_OS_DEBIAN_FREEBSD)
+ set(BFD_LIBRARIES ${BFD_LIBRARIES} iconv)
+ endif()
+ endif()
+endif()
+
+macro(setup_compile_flags)
+ # LY: save initial C/CXX flags
+ if(NOT INITIAL_CMAKE_FLAGS_SAVED)
+ if(MSVC)
+ string(REGEX REPLACE "^(.*)(/EHsc)( *)(.*)$" "\\1/EHs\\3\\4" CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS}")
+ endif()
+ set(INITIAL_CMAKE_CXX_FLAGS ${CMAKE_CXX_FLAGS} CACHE STRING "Initial CMake's flags" FORCE)
+ set(INITIAL_CMAKE_C_FLAGS ${CMAKE_C_FLAGS} CACHE STRING "Initial CMake's flags" FORCE)
+ set(INITIAL_CMAKE_EXE_LINKER_FLAGS ${CMAKE_EXE_LINKER_FLAGS} CACHE STRING "Initial CMake's flags" FORCE)
+ set(INITIAL_CMAKE_SHARED_LINKER_FLAGS ${CMAKE_SHARED_LINKER_FLAGS} CACHE STRING "Initial CMake's flags" FORCE)
+ set(INITIAL_CMAKE_STATIC_LINKER_FLAGS ${CMAKE_STATIC_LINKER_FLAGS} CACHE STRING "Initial CMake's flags" FORCE)
+ set(INITIAL_CMAKE_MODULE_LINKER_FLAGS ${CMAKE_MODULE_LINKER_FLAGS} CACHE STRING "Initial CMake's flags" FORCE)
+ set(INITIAL_CMAKE_FLAGS_SAVED TRUE CACHE INTERNAL "State of initial CMake's flags" FORCE)
+ endif()
+
+ # LY: reset C/CXX flags
+ set(CXX_FLAGS ${INITIAL_CMAKE_CXX_FLAGS})
+ set(C_FLAGS ${INITIAL_CMAKE_C_FLAGS})
+ set(EXE_LINKER_FLAGS ${INITIAL_CMAKE_EXE_LINKER_FLAGS})
+ set(SHARED_LINKER_FLAGS ${INITIAL_CMAKE_SHARED_LINKER_FLAGS})
+ set(STATIC_LINKER_FLAGS ${INITIAL_CMAKE_STATIC_LINKER_FLAGS})
+ set(MODULE_LINKER_FLAGS ${INITIAL_CMAKE_MODULE_LINKER_FLAGS})
+
+ if(CC_HAS_FEXCEPTIONS)
+ add_compile_flags("C;CXX" "-fexceptions")
+ endif()
+ if(CC_HAS_FCXX_EXCEPTIONS)
+ add_compile_flags("CXX" "-fcxx-exceptions -frtti")
+ endif()
+
+ # In C a global variable without a storage specifier (static/extern) and
+ # without an initialiser is called a ’tentative definition’. The
+ # language permits multiple tentative definitions in the single
+ # translation unit; i.e. int foo; int foo; is perfectly ok. GNU
+ # toolchain goes even further, allowing multiple tentative definitions
+ # in *different* translation units. Internally, variables introduced via
+ # tentative definitions are implemented as ‘common’ symbols. Linker
+ # permits multiple definitions if they are common symbols, and it picks
+ # one arbitrarily for inclusion in the binary being linked.
+ #
+ # -fno-common forces GNU toolchain to behave in a more
+ # standard-conformant way in respect to tentative definitions and it
+ # prevents common symbols generation. Since we are a cross-platform
+ # project it really makes sense. There are toolchains that don’t
+ # implement GNU style handling of the tentative definitions and there
+ # are platforms lacking proper support for common symbols (osx).
+ if(CC_HAS_FNO_COMMON)
+ add_compile_flags("C;CXX" "-fno-common")
+ endif()
+
+ if(CC_HAS_GGDB)
+ add_compile_flags("C;CXX" "-ggdb")
+ endif()
+
+ if(CC_HAS_WNO_UNKNOWN_PRAGMAS AND NOT HAVE_OPENMP)
+ add_compile_flags("C;CXX" -Wno-unknown-pragmas)
+ endif()
+
+ if(CC_HAS_SECTIONS)
+ add_compile_flags("C;CXX" -ffunction-sections -fdata-sections)
+ elseif(MSVC)
+ add_compile_flags("C;CXX" /Gy)
+ endif()
+
+ # We must set -fno-omit-frame-pointer here, since we rely
+ # on frame pointer when getting a backtrace, and it must
+ # be used consistently across all object files.
+ # The same reasoning applies to -fno-stack-protector switch.
+ if(ENABLE_BACKTRACE)
+ if(CC_HAS_FNO_OMIT_FRAME_POINTER)
+ add_compile_flags("C;CXX" "-fno-omit-frame-pointer")
+ endif()
+ endif()
+
+ if(MSVC)
+ if (MSVC_VERSION LESS 1900)
+ message(FATAL_ERROR "At least \"Microsoft C/C++ Compiler\" version 19.0.24234.1 (Visual Studio 2015 Update 3) is required.")
+ endif()
+ add_compile_flags("CXX" "/Zc:__cplusplus")
+ add_compile_flags("C;CXX" "/W4")
+ add_compile_flags("C;CXX" "/utf-8")
+ else()
+ if(CC_HAS_WALL)
+ add_compile_flags("C;CXX" "-Wall")
+ endif()
+ if(CC_HAS_WEXTRA)
+ add_compile_flags("C;CXX" "-Wextra")
+ endif()
+ endif()
+
+ if(CMAKE_COMPILER_IS_GNU${CMAKE_PRIMARY_LANG}
+ AND CMAKE_${CMAKE_PRIMARY_LANG}_COMPILER_VERSION VERSION_LESS 5)
+ # G++ bug. http://gcc.gnu.org/bugzilla/show_bug.cgi?id=31488
+ add_compile_flags("CXX" "-Wno-invalid-offsetof")
+ endif()
+
+ add_definitions("-D__STDC_FORMAT_MACROS=1")
+ add_definitions("-D__STDC_LIMIT_MACROS=1")
+ add_definitions("-D__STDC_CONSTANT_MACROS=1")
+ add_definitions("-D_HAS_EXCEPTIONS=1")
+
+ # Only add -Werror if it's a debug build, done by developers.
+ # Release builds should not cause extra trouble.
+ if(CC_HAS_WERROR AND (CI OR CMAKE_CONFIGURATION_TYPES OR CMAKE_BUILD_TYPE STREQUAL "Debug"))
+ if(MSVC)
+ add_compile_flags("C;CXX" "/WX")
+ elseif(CMAKE_COMPILER_IS_CLANG)
+ if (NOT CMAKE_${CMAKE_PRIMARY_LANG}_COMPILER_VERSION VERSION_LESS 6)
+ add_compile_flags("C;CXX" "-Werror")
+ endif()
+ elseif(CMAKE_COMPILER_IS_GNUCC)
+ if (NOT CMAKE_${CMAKE_PRIMARY_LANG}_COMPILER_VERSION VERSION_LESS 6)
+ add_compile_flags("C;CXX" "-Werror")
+ endif()
+ else()
+ add_compile_flags("C;CXX" "-Werror")
+ endif()
+ endif()
+
+ if(HAVE_OPENMP)
+ add_compile_flags("C;CXX" "-fopenmp")
+ endif()
+
+ if (ENABLE_ASAN)
+ add_compile_flags("C;CXX" -fsanitize=address)
+ endif()
+
+ if(ENABLE_GCOV)
+ if(NOT HAVE_GCOV)
+ message(FATAL_ERROR
+ "ENABLE_GCOV option requested but gcov library is not found")
+ endif()
+
+ add_compile_flags("C;CXX" "-fprofile-arcs" "-ftest-coverage")
+ set(EXE_LINKER_FLAGS "${EXE_LINKER_FLAGS} -fprofile-arcs -ftest-coverage")
+ set(SHARED_LINKER_FLAGS "${SHARED_LINKER_FLAGS} -fprofile-arcs -ftest-coverage")
+ set(MODULE_LINKER_FLAGS "${MODULE_LINKER_FLAGS} -fprofile-arcs -ftest-coverage")
+ # add_library(gcov SHARED IMPORTED)
+ endif()
+
+ if(ENABLE_GPROF)
+ add_compile_flags("C;CXX" "-pg")
+ endif()
+
+ if(CMAKE_COMPILER_IS_GNUCC AND LTO_ENABLED)
+ add_compile_flags("C;CXX" ${GCC_LTO_CFLAGS})
+ set(EXE_LINKER_FLAGS "${EXE_LINKER_FLAGS} ${GCC_LTO_CFLAGS} -fverbose-asm -fwhole-program")
+ set(SHARED_LINKER_FLAGS "${SHARED_LINKER_FLAGS} ${GCC_LTO_CFLAGS} -fverbose-asm")
+ set(MODULE_LINKER_FLAGS "${MODULE_LINKER_FLAGS} ${GCC_LTO_CFLAGS} -fverbose-asm")
+ if(CMAKE_CXX_COMPILER_VERSION VERSION_LESS 5)
+ # Pass the same optimization flags to the linker
+ set(compile_flags "${CMAKE_C_FLAGS} ${CMAKE_C_FLAGS_${CMAKE_BUILD_TYPE_UPPERCASE}}")
+ set(EXE_LINKER_FLAGS "${EXE_LINKER_FLAGS} ${compile_flags}")
+ set(SHARED_LINKER_FLAGS "${SHARED_LINKER_FLAGS} ${compile_flags}")
+ set(MODULE_LINKER_FLAGS "${MODULE_LINKER_FLAGS} ${compile_flags}")
+ unset(compile_flags)
+ else()
+ add_compile_flags("CXX" "-flto-odr-type-merging")
+ endif()
+ endif()
+
+ if(MSVC AND LTO_ENABLED)
+ add_compile_flags("C;CXX" "/GL")
+ foreach(linkmode IN ITEMS EXE SHARED STATIC MODULE)
+ set(${linkmode}_LINKER_FLAGS "${${linkmode}_LINKER_FLAGS} /LTCG")
+ string(REGEX REPLACE "^(.*)(/INCREMENTAL:NO *)(.*)$" "\\1\\3" ${linkmode}_LINKER_FLAGS "${${linkmode}_LINKER_FLAGS}")
+ string(REGEX REPLACE "^(.*)(/INCREMENTAL:YES *)(.*)$" "\\1\\3" ${linkmode}_LINKER_FLAGS "${${linkmode}_LINKER_FLAGS}")
+ string(REGEX REPLACE "^(.*)(/INCREMENTAL *)(.*)$" "\\1\\3" ${linkmode}_LINKER_FLAGS "${${linkmode}_LINKER_FLAGS}")
+ string(STRIP "${${linkmode}_LINKER_FLAGS}" ${linkmode}_LINKER_FLAGS)
+ foreach(config IN LISTS CMAKE_CONFIGURATION_TYPES ITEMS Release MinSizeRel RelWithDebInfo Debug)
+ string(TOUPPER "${config}" config_uppercase)
+ if(DEFINED "CMAKE_${linkmode}_LINKER_FLAGS_${config_uppercase}")
+ string(REGEX REPLACE "^(.*)(/INCREMENTAL:NO *)(.*)$" "\\1\\3" altered_flags "${CMAKE_${linkmode}_LINKER_FLAGS_${config_uppercase}}")
+ string(REGEX REPLACE "^(.*)(/INCREMENTAL:YES *)(.*)$" "\\1\\3" altered_flags "${altered_flags}")
+ string(REGEX REPLACE "^(.*)(/INCREMENTAL *)(.*)$" "\\1\\3" altered_flags "${altered_flags}")
+ string(STRIP "${altered_flags}" altered_flags)
+ if(NOT "${altered_flags}" STREQUAL "${CMAKE_${linkmode}_LINKER_FLAGS_${config_uppercase}}")
+ set(CMAKE_${linkmode}_LINKER_FLAGS_${config_uppercase} "${altered_flags}" CACHE STRING "Altered: '/INCREMENTAL' removed for LTO" FORCE)
+ endif()
+ endif()
+ endforeach(config)
+ endforeach(linkmode)
+ unset(linkmode)
+
+ foreach(config IN LISTS CMAKE_CONFIGURATION_TYPES ITEMS Release MinSizeRel RelWithDebInfo)
+ foreach(lang IN ITEMS C CXX)
+ string(TOUPPER "${config}" config_uppercase)
+ if(DEFINED "CMAKE_${lang}_FLAGS_${config_uppercase}")
+ string(REPLACE "/O2" "/Ox" altered_flags "${CMAKE_${lang}_FLAGS_${config_uppercase}}")
+ if(NOT "${altered_flags}" STREQUAL "${CMAKE_${lang}_FLAGS_${config_uppercase}}")
+ set(CMAKE_${lang}_FLAGS_${config_uppercase} "${altered_flags}" CACHE STRING "Altered: '/O2' replaced by '/Ox' for LTO" FORCE)
+ endif()
+ endif()
+ unset(config_uppercase)
+ endforeach(lang)
+ endforeach(config)
+ unset(altered_flags)
+ unset(lang)
+ unset(config)
+ endif()
+
+ if(CMAKE_COMPILER_IS_CLANG AND OSX_ARCHITECTURES)
+ set(EXE_LINKER_FLAGS "${EXE_LINKER_FLAGS} -Wl,-keep_dwarf_unwind")
+ set(SHARED_LINKER_FLAGS "${SHARED_LINKER_FLAGS} -Wl,-keep_dwarf_unwind")
+ set(MODULE_LINKER_FLAGS "${MODULE_LINKER_FLAGS} -Wl,-keep_dwarf_unwind")
+ endif()
+
+ if(CMAKE_COMPILER_IS_CLANG AND LTO_ENABLED)
+ if(CMAKE_${CMAKE_PRIMARY_LANG}_COMPILER_VERSION VERSION_LESS 3.9)
+ set(CLANG_LTO_FLAG "-flto")
+ else()
+ set(CLANG_LTO_FLAG "-flto=thin")
+ endif()
+ add_compile_flags("C;CXX" ${CLANG_LTO_FLAG})
+ set(EXE_LINKER_FLAGS "${EXE_LINKER_FLAGS} ${CLANG_LTO_FLAG} -fverbose-asm -fwhole-program")
+ set(SHARED_LINKER_FLAGS "${SHARED_LINKER_FLAGS} ${CLANG_LTO_FLAG} -fverbose-asm")
+ set(MODULE_LINKER_FLAGS "${MODULE_LINKER_FLAGS} ${CLANG_LTO_FLAG} -fverbose-asm")
+ endif()
+
+ # LY: push C/CXX flags into the cache
+ set(CMAKE_CXX_FLAGS ${CXX_FLAGS} CACHE STRING "Flags used by the C++ compiler during all build types" FORCE)
+ set(CMAKE_C_FLAGS ${C_FLAGS} CACHE STRING "Flags used by the C compiler during all build types" FORCE)
+ set(CMAKE_EXE_LINKER_FLAGS ${EXE_LINKER_FLAGS} CACHE STRING "Flags used by the linker" FORCE)
+ set(CMAKE_SHARED_LINKER_FLAGS ${SHARED_LINKER_FLAGS} CACHE STRING "Flags used by the linker during the creation of dll's" FORCE)
+ set(CMAKE_STATIC_LINKER_FLAGS ${STATIC_LINKER_FLAGS} CACHE STRING "Flags used by the linker during the creation of static libraries" FORCE)
+ set(CMAKE_MODULE_LINKER_FLAGS ${MODULE_LINKER_FLAGS} CACHE STRING "Flags used by the linker during the creation of modules" FORCE)
+ unset(CXX_FLAGS)
+ unset(C_FLAGS)
+ unset(EXE_LINKER_FLAGS)
+ unset(SHARED_LINKER_FLAGS)
+ unset(STATIC_LINKER_FLAGS)
+ unset(MODULE_LINKER_FLAGS)
+endmacro(setup_compile_flags)
+
+# determine library for for std::filesystem
+set(LIBCXX_FILESYSTEM "")
+if(CMAKE_COMPILER_IS_GNUCXX)
+ if (CMAKE_CXX_COMPILER_VERSION VERSION_LESS 9.0)
+ set(LIBCXX_FILESYSTEM "stdc++fs")
+ endif()
+elseif (CMAKE_COMPILER_IS_CLANG)
+ if (CMAKE_CXX_COMPILER_VERSION VERSION_LESS 5.0)
+ set(LIBCXX_FILESYSTEM "c++experimental")
+ else()
+ set(LIBCXX_FILESYSTEM "stdc++fs")
+ endif()
+endif()
+
+cmake_policy(POP)
diff --git a/contrib/db/libmdbx/cmake/profile.cmake b/contrib/db/libmdbx/cmake/profile.cmake
new file mode 100644
index 00000000..6507e8dd
--- /dev/null
+++ b/contrib/db/libmdbx/cmake/profile.cmake
@@ -0,0 +1,45 @@
+## Copyright (c) 2012-2019 Leonid Yuriev .
+##
+## Licensed under the Apache License, Version 2.0 (the "License");
+## you may not use this file except in compliance with the License.
+## You may obtain a copy of the License at
+##
+## http://www.apache.org/licenses/LICENSE-2.0
+##
+## Unless required by applicable law or agreed to in writing, software
+## distributed under the License is distributed on an "AS IS" BASIS,
+## WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+## See the License for the specific language governing permissions and
+## limitations under the License.
+##
+
+cmake_minimum_required(VERSION 3.8.2)
+cmake_policy(PUSH)
+cmake_policy(VERSION 3.8.2)
+
+include(CheckLibraryExists)
+check_library_exists(gcov __gcov_flush "" HAVE_GCOV)
+
+option(ENABLE_GCOV
+ "Enable integration with gcov, a code coverage program" OFF)
+
+option(ENABLE_GPROF
+ "Enable integration with gprof, a performance analyzing tool" OFF)
+
+if(CMAKE_CXX_COMPILER_LOADED)
+ include(CheckIncludeFileCXX)
+ check_include_file_cxx(valgrind/memcheck.h HAVE_VALGRIND_MEMCHECK_H)
+else()
+ include(CheckIncludeFile)
+ check_include_file(valgrind/memcheck.h HAVE_VALGRIND_MEMCHECK_H)
+endif()
+
+option(MDBX_USE_VALGRIND "Enable integration with valgrind, a memory analyzing tool" OFF)
+if(MDBX_USE_VALGRIND AND NOT HAVE_VALGRIND_MEMCHECK_H)
+ message(FATAL_ERROR "MDBX_USE_VALGRIND option is set but valgrind/memcheck.h is not found")
+endif()
+
+option(ENABLE_ASAN
+ "Enable AddressSanitizer, a fast memory error detector based on compiler instrumentation" OFF)
+
+cmake_policy(POP)
diff --git a/contrib/db/libmdbx/cmake/utils.cmake b/contrib/db/libmdbx/cmake/utils.cmake
new file mode 100644
index 00000000..c31f53cd
--- /dev/null
+++ b/contrib/db/libmdbx/cmake/utils.cmake
@@ -0,0 +1,183 @@
+## Copyright (c) 2012-2019 Leonid Yuriev .
+##
+## Licensed under the Apache License, Version 2.0 (the "License");
+## you may not use this file except in compliance with the License.
+## You may obtain a copy of the License at
+##
+## http://www.apache.org/licenses/LICENSE-2.0
+##
+## Unless required by applicable law or agreed to in writing, software
+## distributed under the License is distributed on an "AS IS" BASIS,
+## WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+## See the License for the specific language governing permissions and
+## limitations under the License.
+##
+
+cmake_minimum_required(VERSION 3.8.2)
+cmake_policy(PUSH)
+cmake_policy(VERSION 3.8.2)
+
+macro(add_compile_flags langs)
+ foreach(_lang ${langs})
+ string(REPLACE ";" " " _flags "${ARGN}")
+ if(CMAKE_CXX_COMPILER_LOADED AND _lang STREQUAL "CXX")
+ set("${_lang}_FLAGS" "${${_lang}_FLAGS} ${_flags}")
+ endif()
+ if(CMAKE_C_COMPILER_LOADED AND _lang STREQUAL "C")
+ set("${_lang}_FLAGS" "${${_lang}_FLAGS} ${_flags}")
+ endif()
+ endforeach()
+ unset(_lang)
+ unset(_flags)
+endmacro(add_compile_flags)
+
+macro(set_source_files_compile_flags)
+ foreach(file ${ARGN})
+ get_filename_component(_file_ext ${file} EXT)
+ set(_lang "")
+ if("${_file_ext}" STREQUAL ".m")
+ set(_lang OBJC)
+ # CMake believes that Objective C is a flavor of C++, not C,
+ # and uses g++ compiler for .m files.
+ # LANGUAGE property forces CMake to use CC for ${file}
+ set_source_files_properties(${file} PROPERTIES LANGUAGE C)
+ elseif("${_file_ext}" STREQUAL ".mm")
+ set(_lang OBJCXX)
+ endif()
+
+ if(_lang)
+ get_source_file_property(_flags ${file} COMPILE_FLAGS)
+ if("${_flags}" STREQUAL "NOTFOUND")
+ set(_flags "${CMAKE_${_lang}_FLAGS}")
+ else()
+ set(_flags "${_flags} ${CMAKE_${_lang}_FLAGS}")
+ endif()
+ # message(STATUS "Set (${file} ${_flags}")
+ set_source_files_properties(${file} PROPERTIES COMPILE_FLAGS
+ "${_flags}")
+ endif()
+ endforeach()
+ unset(_file_ext)
+ unset(_lang)
+endmacro(set_source_files_compile_flags)
+
+macro(fetch_version name version_file)
+ set(${name}_VERSION "")
+ set(${name}_GIT_DESCRIBE "")
+ set(${name}_GIT_TIMESTAMP "")
+ set(${name}_GIT_TREE "")
+ set(${name}_GIT_COMMIT "")
+ set(${name}_GIT_REVISION 0)
+ set(${name}_GIT_VERSION "")
+ if(GIT)
+ execute_process(COMMAND ${GIT} describe --tags --long --dirty=-dirty
+ OUTPUT_VARIABLE ${name}_GIT_DESCRIBE
+ OUTPUT_STRIP_TRAILING_WHITESPACE
+ WORKING_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}
+ RESULT_VARIABLE rc)
+ if(rc OR "${name}_GIT_DESCRIBE" STREQUAL "")
+ message(FATAL_ERROR "Please fetch tags and/or install latest version of git ('describe --tags --long --dirty' failed)")
+ endif()
+
+ execute_process(COMMAND ${GIT} show --no-patch --format=%cI HEAD
+ OUTPUT_VARIABLE ${name}_GIT_TIMESTAMP
+ OUTPUT_STRIP_TRAILING_WHITESPACE
+ WORKING_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}
+ RESULT_VARIABLE rc)
+ if(rc OR "${name}_GIT_TIMESTAMP" STREQUAL "%cI")
+ execute_process(COMMAND ${GIT} show --no-patch --format=%ci HEAD
+ OUTPUT_VARIABLE ${name}_GIT_TIMESTAMP
+ OUTPUT_STRIP_TRAILING_WHITESPACE
+ WORKING_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}
+ RESULT_VARIABLE rc)
+ if(rc OR "${name}_GIT_TIMESTAMP" STREQUAL "%ci")
+ message(FATAL_ERROR "Please install latest version of git ('show --no-patch --format=%cI HEAD' failed)")
+ endif()
+ endif()
+
+ execute_process(COMMAND ${GIT} show --no-patch --format=%T HEAD
+ OUTPUT_VARIABLE ${name}_GIT_TREE
+ OUTPUT_STRIP_TRAILING_WHITESPACE
+ WORKING_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}
+ RESULT_VARIABLE rc)
+ if(rc OR "${name}_GIT_TREE" STREQUAL "")
+ message(FATAL_ERROR "Please install latest version of git ('show --no-patch --format=%T HEAD' failed)")
+ endif()
+
+ execute_process(COMMAND ${GIT} show --no-patch --format=%H HEAD
+ OUTPUT_VARIABLE ${name}_GIT_COMMIT
+ OUTPUT_STRIP_TRAILING_WHITESPACE
+ WORKING_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}
+ RESULT_VARIABLE rc)
+ if(rc OR "${name}_GIT_COMMIT" STREQUAL "")
+ message(FATAL_ERROR "Please install latest version of git ('show --no-patch --format=%H HEAD' failed)")
+ endif()
+
+ execute_process(COMMAND ${GIT} rev-list --count --no-merges HEAD
+ OUTPUT_VARIABLE ${name}_GIT_REVISION
+ OUTPUT_STRIP_TRAILING_WHITESPACE
+ WORKING_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}
+ RESULT_VARIABLE rc)
+ if(rc OR "${name}_GIT_REVISION" STREQUAL "")
+ message(FATAL_ERROR "Please install latest version of git ('rev-list --count --no-merges HEAD' failed)")
+ endif()
+
+ string(REGEX MATCH "^(v)?([0-9]+)\\.([0-9]+)\\.([0-9]+)(.*)?" git_version_valid "${${name}_GIT_DESCRIBE}")
+ if(git_version_valid)
+ string(REGEX REPLACE "^(v)?([0-9]+)\\.([0-9]+)\\.([0-9]+)(.*)?" "\\2;\\3;\\4" ${name}_GIT_VERSION ${${name}_GIT_DESCRIBE})
+ else()
+ string(REGEX MATCH "^(v)?([0-9]+)\\.([0-9]+)(.*)?" git_version_valid "${${name}_GIT_DESCRIBE}")
+ if(git_version_valid)
+ string(REGEX REPLACE "^(v)?([0-9]+)\\.([0-9]+)(.*)?" "\\2;\\3;0" ${name}_GIT_VERSION ${${name}_GIT_DESCRIBE})
+ else()
+ message(AUTHOR_WARNING "Bad ${name} version \"${${name}_GIT_DESCRIBE}\"; falling back to 0.0.0 (have you made an initial release?)")
+ set(${name}_GIT_VERSION "0;0;0")
+ endif()
+ endif()
+ endif()
+
+ if(NOT ${name}_GIT_VERSION OR NOT ${name}_GIT_TIMESTAMP OR NOT ${name}_GIT_REVISION)
+ message(WARNING "Unable to retrive ${name} version from git.")
+ set(${name}_GIT_VERSION "0;0;0;0")
+ set(${name}_GIT_TIMESTAMP "")
+ set(${name}_GIT_REVISION 0)
+
+ # Try to get version from VERSION file
+ if(EXISTS "${version_file}")
+ file(STRINGS "${version_file}" ${name}_VERSION)
+ endif()
+
+ if(NOT ${name}_VERSION)
+ message(WARNING "Unable to retrive ${name} version from \"${version_file}\" file.")
+ set(${name}_VERSION_LIST ${${name}_GIT_VERSION})
+ string(REPLACE ";" "." ${name}_VERSION "${${name}_GIT_VERSION}")
+ else()
+ string(REPLACE "." ";" ${name}_VERSION_LIST ${${name}_VERSION})
+ endif()
+
+ else()
+ list(APPEND ${name}_GIT_VERSION ${${name}_GIT_REVISION})
+ set(${name}_VERSION_LIST ${${name}_GIT_VERSION})
+ string(REPLACE ";" "." ${name}_VERSION "${${name}_GIT_VERSION}")
+ endif()
+
+ list(GET ${name}_VERSION_LIST 0 "${name}_VERSION_MAJOR")
+ list(GET ${name}_VERSION_LIST 1 "${name}_VERSION_MINOR")
+ list(GET ${name}_VERSION_LIST 2 "${name}_VERSION_RELEASE")
+ list(GET ${name}_VERSION_LIST 3 "${name}_VERSION_REVISION")
+
+ set(${name}_VERSION_MAJOR ${${name}_VERSION_MAJOR} PARENT_SCOPE)
+ set(${name}_VERSION_MINOR ${${name}_VERSION_MINOR} PARENT_SCOPE)
+ set(${name}_VERSION_RELEASE ${${name}_VERSION_RELEASE} PARENT_SCOPE)
+ set(${name}_VERSION_REVISION ${${name}_VERSION_REVISION} PARENT_SCOPE)
+ set(${name}_VERSION ${${name}_VERSION} PARENT_SCOPE)
+
+ set(${name}_GIT_DESCRIBE ${${name}_GIT_DESCRIBE} PARENT_SCOPE)
+ set(${name}_GIT_TIMESTAMP ${${name}_GIT_TIMESTAMP} PARENT_SCOPE)
+ set(${name}_GIT_TREE ${${name}_GIT_TREE} PARENT_SCOPE)
+ set(${name}_GIT_COMMIT ${${name}_GIT_COMMIT} PARENT_SCOPE)
+ set(${name}_GIT_REVISION ${${name}_GIT_REVISION} PARENT_SCOPE)
+ set(${name}_GIT_VERSION ${${name}_GIT_VERSION} PARENT_SCOPE)
+endmacro(fetch_version)
+
+cmake_policy(POP)
diff --git a/contrib/db/libmdbx/example/CMakeLists.txt b/contrib/db/libmdbx/example/CMakeLists.txt
new file mode 100644
index 00000000..d3e56e82
--- /dev/null
+++ b/contrib/db/libmdbx/example/CMakeLists.txt
@@ -0,0 +1,6 @@
+set(TARGET mdbx_example)
+project(${TARGET})
+
+add_executable(${TARGET} example-mdbx.c)
+
+target_link_libraries(${TARGET} mdbx)
diff --git a/contrib/db/libmdbx/example/README.md b/contrib/db/libmdbx/example/README.md
new file mode 100644
index 00000000..b819cf4a
--- /dev/null
+++ b/contrib/db/libmdbx/example/README.md
@@ -0,0 +1 @@
+See [example-mdbx.c](example-mdbx.c) as an example of using _libmdbx_, and do a line-by-line comparison of it with the [sample-bdb.txt](sample-bdb.txt) file.
diff --git a/contrib/db/libmdbx/example/example-mdbx.c b/contrib/db/libmdbx/example/example-mdbx.c
new file mode 100644
index 00000000..1d25ef6f
--- /dev/null
+++ b/contrib/db/libmdbx/example/example-mdbx.c
@@ -0,0 +1,112 @@
+/* MDBX usage examle
+ *
+ * Do a line-by-line comparison of this and sample-bdb.txt
+ */
+
+/*
+ * Copyright 2015-2019 Leonid Yuriev .
+ * Copyright 2017 Ilya Shipitsin .
+ * Copyright 2012-2015 Howard Chu, Symas Corp.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted only as authorized by the OpenLDAP
+ * Public License.
+ *
+ * A copy of this license is available in the file LICENSE in the
+ * top-level directory of the distribution or, alternatively, at
+ * .
+ */
+
+#include "mdbx.h"
+#include
+#include
+
+int main(int argc, char *argv[]) {
+ (void)argc;
+ (void)argv;
+
+ int rc;
+ MDBX_env *env = NULL;
+ MDBX_dbi dbi = 0;
+ MDBX_val key, data;
+ MDBX_txn *txn = NULL;
+ MDBX_cursor *cursor = NULL;
+ char sval[32];
+
+ rc = mdbx_env_create(&env);
+ if (rc != MDBX_SUCCESS) {
+ fprintf(stderr, "mdbx_env_create: (%d) %s\n", rc, mdbx_strerror(rc));
+ goto bailout;
+ }
+ rc = mdbx_env_open(env, "./example-db",
+ MDBX_NOSUBDIR | MDBX_COALESCE | MDBX_LIFORECLAIM, 0664);
+ if (rc != MDBX_SUCCESS) {
+ fprintf(stderr, "mdbx_env_open: (%d) %s\n", rc, mdbx_strerror(rc));
+ goto bailout;
+ }
+
+ rc = mdbx_txn_begin(env, NULL, 0, &txn);
+ if (rc != MDBX_SUCCESS) {
+ fprintf(stderr, "mdbx_txn_begin: (%d) %s\n", rc, mdbx_strerror(rc));
+ goto bailout;
+ }
+ rc = mdbx_dbi_open(txn, NULL, 0, &dbi);
+ if (rc != MDBX_SUCCESS) {
+ fprintf(stderr, "mdbx_dbi_open: (%d) %s\n", rc, mdbx_strerror(rc));
+ goto bailout;
+ }
+
+ key.iov_len = sizeof(int);
+ key.iov_base = sval;
+ data.iov_len = sizeof(sval);
+ data.iov_base = sval;
+
+ sprintf(sval, "%03x %d foo bar", 32, 3141592);
+ rc = mdbx_put(txn, dbi, &key, &data, 0);
+ if (rc != MDBX_SUCCESS) {
+ fprintf(stderr, "mdbx_put: (%d) %s\n", rc, mdbx_strerror(rc));
+ goto bailout;
+ }
+ rc = mdbx_txn_commit(txn);
+ if (rc) {
+ fprintf(stderr, "mdbx_txn_commit: (%d) %s\n", rc, mdbx_strerror(rc));
+ goto bailout;
+ }
+ txn = NULL;
+
+ rc = mdbx_txn_begin(env, NULL, MDBX_RDONLY, &txn);
+ if (rc != MDBX_SUCCESS) {
+ fprintf(stderr, "mdbx_txn_begin: (%d) %s\n", rc, mdbx_strerror(rc));
+ goto bailout;
+ }
+ rc = mdbx_cursor_open(txn, dbi, &cursor);
+ if (rc != MDBX_SUCCESS) {
+ fprintf(stderr, "mdbx_cursor_open: (%d) %s\n", rc, mdbx_strerror(rc));
+ goto bailout;
+ }
+
+ int found = 0;
+ while ((rc = mdbx_cursor_get(cursor, &key, &data, MDBX_NEXT)) == 0) {
+ printf("key: %p %.*s, data: %p %.*s\n", key.iov_base, (int)key.iov_len,
+ (char *)key.iov_base, data.iov_base, (int)data.iov_len,
+ (char *)data.iov_base);
+ found += 1;
+ }
+ if (rc != MDBX_NOTFOUND || found == 0) {
+ fprintf(stderr, "mdbx_cursor_get: (%d) %s\n", rc, mdbx_strerror(rc));
+ goto bailout;
+ } else {
+ rc = MDBX_SUCCESS;
+ }
+bailout:
+ if (cursor)
+ mdbx_cursor_close(cursor);
+ if (txn)
+ mdbx_txn_abort(txn);
+ if (dbi)
+ mdbx_dbi_close(env, dbi);
+ if (env)
+ mdbx_env_close(env);
+ return (rc != MDBX_SUCCESS) ? EXIT_FAILURE : EXIT_SUCCESS;
+}
diff --git a/contrib/db/libmdbx/example/sample-bdb.txt b/contrib/db/libmdbx/example/sample-bdb.txt
new file mode 100644
index 00000000..5c89540a
--- /dev/null
+++ b/contrib/db/libmdbx/example/sample-bdb.txt
@@ -0,0 +1,77 @@
+/* BerkeleyDB toy/sample
+ *
+ * Do a line-by-line comparison of this and example-mdbx.c
+ */
+
+/*
+ * Copyright 2015-2019 Leonid Yuriev .
+ * Copyright 2012-2015 Howard Chu, Symas Corp.
+ * Copyright 2015,2016 Peter-Service R&D LLC.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted only as authorized by the OpenLDAP
+ * Public License.
+ *
+ * A copy of this license is available in the file LICENSE in the
+ * top-level directory of the distribution or, alternatively, at
+ * .
+ */
+
+#include
+#include
+#include
+
+int main(int argc,char * argv[])
+{
+ int rc;
+ DB_ENV *env;
+ DB *dbi;
+ DBT key, data;
+ DB_TXN *txn;
+ DBC *cursor;
+ char sval[32], kval[32];
+
+ /* Note: Most error checking omitted for simplicity */
+
+#define FLAGS (DB_INIT_LOCK|DB_INIT_LOG|DB_INIT_TXN|DB_INIT_MPOOL|DB_CREATE|DB_THREAD)
+ rc = db_env_create(&env, 0);
+ rc = env->open(env, "./testdb", FLAGS, 0664);
+ rc = db_create(&dbi, env, 0);
+ rc = env->txn_begin(env, NULL, &txn, 0);
+ rc = dbi->open(dbi, txn, "test.bdb", NULL, DB_BTREE, DB_CREATE, 0664);
+
+ memset(&key, 0, sizeof(DBT));
+ memset(&data, 0, sizeof(DBT));
+ key.size = sizeof(int);
+ key.data = sval;
+ data.size = sizeof(sval);
+ data.data = sval;
+
+ sprintf(sval, "%03x %d foo bar", 32, 3141592);
+ rc = dbi->put(dbi, txn, &key, &data, 0);
+ rc = txn->commit(txn, 0);
+ if (rc) {
+ fprintf(stderr, "txn->commit: (%d) %s\n", rc, db_strerror(rc));
+ goto leave;
+ }
+ rc = env->txn_begin(env, NULL, &txn, 0);
+ rc = dbi->cursor(dbi, txn, &cursor, 0);
+ key.flags = DB_DBT_USERMEM;
+ key.data = kval;
+ key.ulen = sizeof(kval);
+ data.flags = DB_DBT_USERMEM;
+ data.data = sval;
+ data.ulen = sizeof(sval);
+ while ((rc = cursor->c_get(cursor, &key, &data, DB_NEXT)) == 0) {
+ printf("key: %p %.*s, data: %p %.*s\n",
+ key.data, (int) key.size, (char *) key.data,
+ data.data, (int) data.size, (char *) data.data);
+ }
+ rc = cursor->c_close(cursor);
+ rc = txn->abort(txn);
+leave:
+ rc = dbi->close(dbi, 0);
+ rc = env->close(env, 0);
+ return rc;
+}
diff --git a/contrib/db/libmdbx/mdbx.h b/contrib/db/libmdbx/mdbx.h
new file mode 100644
index 00000000..a52335b3
--- /dev/null
+++ b/contrib/db/libmdbx/mdbx.h
@@ -0,0 +1,3497 @@
+/**** BRIEFLY ******************************************************************
+ *
+ * libmdbx is superior to LMDB (https://bit.ly/26ts7tL) in terms of features
+ * and reliability, not inferior in performance. In comparison to LMDB, libmdbx
+ * makes many things just work perfectly, not silently and catastrophically
+ * break down. libmdbx supports Linux, Windows, MacOS, FreeBSD and other
+ * systems compliant with POSIX.1-2008.
+ *
+ * Look below for API description, for other information (build, embedding and
+ * amalgamation, improvements over LMDB, benchmarking, etc) please refer to
+ * README.md at https://abf.io/erthink/libmdbx.
+ *
+ * ---
+ *
+ * The next version is under active non-public development and will be released
+ * as MithrilDB and libmithrildb for libraries & packages. Admittedly mythical
+ * Mithril is resembling silver but being stronger and lighter than steel.
+ * Therefore MithrilDB is rightly relevant name.
+ *
+ * MithrilDB will be radically different from libmdbx by the new database format
+ * and API based on C++17, as well as the Apache 2.0 License. The goal of this
+ * revolution is to provide a clearer and robust API, add more features and new
+ * valuable properties of database.
+ *
+ * The Future will (be) Positive. Всё будет хорошо.
+ *
+ *
+ **** INTRODUCTION *************************************************************
+ *
+ * // For the most part, this section is a copy of the corresponding text
+ * // from LMDB description, but with some edits reflecting the improvements
+ * // and enhancements were made in MDBX.
+ *
+ * MDBX is a Btree-based database management library modeled loosely on the
+ * BerkeleyDB API, but much simplified. The entire database (aka "environment")
+ * is exposed in a memory map, and all data fetches return data directly from
+ * the mapped memory, so no malloc's or memcpy's occur during data fetches.
+ * As such, the library is extremely simple because it requires no page caching
+ * layer of its own, and it is extremely high performance and memory-efficient.
+ * It is also fully transactional with full ACID semantics, and when the memory
+ * map is read-only, the database integrity cannot be corrupted by stray pointer
+ * writes from application code.
+ *
+ * The library is fully thread-aware and supports concurrent read/write access
+ * from multiple processes and threads. Data pages use a copy-on-write strategy
+ * so no active data pages are ever overwritten, which also provides resistance
+ * to corruption and eliminates the need of any special recovery procedures
+ * after a system crash. Writes are fully serialized; only one write transaction
+ * may be active at a time, which guarantees that writers can never deadlock.
+ * The database structure is multi-versioned so readers run with no locks;
+ * writers cannot block readers, and readers don't block writers.
+ *
+ * Unlike other well-known database mechanisms which use either write-ahead
+ * transaction logs or append-only data writes, MDBX requires no maintenance
+ * during operation. Both write-ahead loggers and append-only databases require
+ * periodic checkpointing and/or compaction of their log or database files
+ * otherwise they grow without bound. MDBX tracks free pages within the database
+ * and re-uses them for new write operations, so the database size does not grow
+ * without bound in normal use. It is worth noting that the "next" version
+ * libmdbx (MithrilDB) will solve this problem.
+ *
+ * The memory map can be used as a read-only or read-write map. It is read-only
+ * by default as this provides total immunity to corruption. Using read-write
+ * mode offers much higher write performance, but adds the possibility for stray
+ * application writes thru pointers to silently corrupt the database.
+ * Of course if your application code is known to be bug-free (...) then this is
+ * not an issue.
+ *
+ * If this is your first time using a transactional embedded key-value store,
+ * you may find the "GETTING STARTED" section below to be helpful.
+ *
+ *
+ **** GETTING STARTED **********************************************************
+ *
+ * // This section is based on Bert Hubert's intro "LMDB Semantics", with
+ * // edits reflecting the improvements and enhancements were made in MDBX.
+ * // See https://bit.ly/2maejGY for Bert Hubert's original.
+ *
+ * Everything starts with an environment, created by mdbx_env_create().
+ * Once created, this environment must also be opened with mdbx_env_open(),
+ * and after use be closed by mdbx_env_close(). At that a non-zero value of the
+ * last argument "mode" supposes MDBX will create database and directory if ones
+ * does not exist. In this case the non-zero "mode" argument specifies the file
+ * mode bits be applied when a new files are created by open() function.
+ *
+ * Within that directory, a lock file (aka LCK-file) and a storage file (aka
+ * DXB-file) will be generated. If you don't want to use a directory, you can
+ * pass the MDBX_NOSUBDIR option, in which case the path you provided is used
+ * directly as the DXB-file, and another file with a "-lck" suffix added
+ * will be used for the LCK-file.
+ *
+ * Once the environment is open, a transaction can be created within it using
+ * mdbx_txn_begin(). Transactions may be read-write or read-only, and read-write
+ * transactions may be nested. A transaction must only be used by one thread at
+ * a time. Transactions are always required, even for read-only access. The
+ * transaction provides a consistent view of the data.
+ *
+ * Once a transaction has been created, a database (i.e. key-value space inside
+ * the environment) can be opened within it using mdbx_dbi_open(). If only one
+ * database will ever be used in the environment, a NULL can be passed as the
+ * database name. For named databases, the MDBX_CREATE flag must be used to
+ * create the database if it doesn't already exist. Also, mdbx_env_set_maxdbs()
+ * must be called after mdbx_env_create() and before mdbx_env_open() to set the
+ * maximum number of named databases you want to support.
+ *
+ * NOTE: a single transaction can open multiple databases. Generally databases
+ * should only be opened once, by the first transaction in the process.
+ *
+ * Within a transaction, mdbx_get() and mdbx_put() can store single key-value
+ * pairs if that is all you need to do (but see CURSORS below if you want to do
+ * more).
+ *
+ * A key-value pair is expressed as two MDBX_val structures. This struct that is
+ * exactly similar to POSIX's struct iovec and has two fields, iov_len and
+ * iov_base. The data is a void pointer to an array of iov_len bytes.
+ * (!) The notable difference between MDBX and LMDB is that MDBX support zero
+ * length keys.
+ *
+ * Because MDBX is very efficient (and usually zero-copy), the data returned in
+ * an MDBX_val structure may be memory-mapped straight from disk. In other words
+ * look but do not touch (or free() for that matter). Once a transaction is
+ * closed, the values can no longer be used, so make a copy if you need to keep
+ * them after that.
+ *
+ *
+ * CURSORS -- To do more powerful things, we must use a cursor.
+ *
+ * Within the transaction, a cursor can be created with mdbx_cursor_open().
+ * With this cursor we can store/retrieve/delete (multiple) values using
+ * mdbx_cursor_get(), mdbx_cursor_put(), and mdbx_cursor_del().
+ *
+ * mdbx_cursor_get() positions itself depending on the cursor operation
+ * requested, and for some operations, on the supplied key. For example, to list
+ * all key-value pairs in a database, use operation MDBX_FIRST for the first
+ * call to mdbx_cursor_get(), and MDBX_NEXT on subsequent calls, until the end
+ * is hit.
+ *
+ * To retrieve all keys starting from a specified key value, use MDBX_SET. For
+ * more cursor operations, see the API description below.
+ *
+ * When using mdbx_cursor_put(), either the function will position the cursor
+ * for you based on the key, or you can use operation MDBX_CURRENT to use the
+ * current position of the cursor. NOTE that key must then match the current
+ * position's key.
+ *
+ *
+ * SUMMARIZING THE OPENING
+ *
+ * So we have a cursor in a transaction which opened a database in an
+ * environment which is opened from a filesystem after it was separately
+ * created.
+ *
+ * Or, we create an environment, open it from a filesystem, create a transaction
+ * within it, open a database within that transaction, and create a cursor
+ * within all of the above.
+ *
+ * Got it?
+ *
+ *
+ * THREADS AND PROCESSES
+ *
+ * Do not have open an database twice in the same process at the same time, MDBX
+ * will track and prevent this. Instead, share the MDBX environment that has
+ * opened the file across all threads. The reason for this is:
+ * - When the "Open file description" locks (aka OFD-locks) are not available,
+ * MDBX uses POSIX locks on files, and these locks have issues if one process
+ * opens a file multiple times.
+ * - If a single process opens the same environment multiple times, closing it
+ * once will remove all the locks held on it, and the other instances will be
+ * vulnerable to corruption from other processes.
+ * + For compatibility with LMDB which allows multi-opening, MDBX can be
+ * configured at runtime by mdbx_setup_debug(MDBX_DBG_LEGACY_MULTIOPEN, ...)
+ * prior to calling other MDBX funcitons. In this way MDBX will track
+ * databases opening, detect multi-opening cases and then recover POSIX file
+ * locks as necessary. However, lock recovery can cause unexpected pauses,
+ * such as when another process opened the database in exclusive mode before
+ * the lock was restored - we have to wait until such a process releases the
+ * database, and so on.
+ *
+ * Do not use opened MDBX environment(s) after fork() in a child process(es),
+ * MDBX will check and prevent this at critical points. Instead, ensure there is
+ * no open MDBX-instance(s) during fork(), or atleast close it immediately after
+ * fork() in the child process and reopen if required - for instance by using
+ * pthread_atfork(). The reason for this is:
+ * - For competitive consistent reading, MDBX assigns a slot in the shared
+ * table for each process that interacts with the database. This slot is
+ * populated with process attributes, including the PID.
+ * - After fork(), in order to remain connected to a database, the child
+ * process must have its own such "slot", which can't be assigned in any
+ * simple and robust way another than the regular.
+ * - A write transaction from a parent process cannot continue in a child
+ * process for obvious reasons.
+ * - Moreover, in a multithreaded process at the fork() moment any number of
+ * threads could run in critical and/or intermediate sections of MDBX code
+ * with interaction and/or racing conditions with threads from other
+ * process(es). For instance: shrinking a database or copying it to a pipe,
+ * opening or closing environment, begining or finishing a transaction,
+ * and so on.
+ * = Therefore, any solution other than simply close database (and reopen if
+ * necessary) in a child process would be both extreme complicated and so
+ * fragile.
+ *
+ * Also note that a transaction is tied to one thread by default using Thread
+ * Local Storage. If you want to pass read-only transactions across threads,
+ * you can use the MDBX_NOTLS option on the environment. Nevertheless, a write
+ * transaction entirely should only be used in one thread from start to finish.
+ * MDBX checks this in a reasonable manner and return the MDBX_THREAD_MISMATCH
+ * error in rules violation.
+ *
+ *
+ * TRANSACTIONS, ROLLBACKS, etc.
+ *
+ * To actually get anything done, a transaction must be committed using
+ * mdbx_txn_commit(). Alternatively, all of a transaction's operations
+ * can be discarded using mdbx_txn_abort().
+ *
+ * (!) An important difference between MDBX and LMDB is that MDBX required that
+ * any opened cursors can be reused and must be freed explicitly, regardless
+ * ones was opened in a read-only or write transaction. The REASON for this is
+ * eliminates ambiguity which helps to avoid errors such as: use-after-free,
+ * double-free, i.e. memory corruption and segfaults.
+ *
+ * For read-only transactions, obviously there is nothing to commit to storage.
+ * (!) An another notable difference between MDBX and LMDB is that MDBX make
+ * handles opened for existing databases immediately available for other
+ * transactions, regardless this transaction will be aborted or reset. The
+ * REASON for this is to avoiding the requirement for multiple opening a same
+ * handles in concurrent read transactions, and tracking of such open but hidden
+ * handles until the completion of read transactions which opened them.
+ *
+ * In addition, as long as a transaction is open, a consistent view of the
+ * database is kept alive, which requires storage. A read-only transaction that
+ * no longer requires this consistent view should be terminated (committed or
+ * aborted) when the view is no longer needed (but see below for an
+ * optimization).
+ *
+ * There can be multiple simultaneously active read-only transactions but only
+ * one that can write. Once a single read-write transaction is opened, all
+ * further attempts to begin one will block until the first one is committed or
+ * aborted. This has no effect on read-only transactions, however, and they may
+ * continue to be opened at any time.
+ *
+ *
+ * DUPLICATE KEYS
+ *
+ * mdbx_get() and mdbx_put() respectively have no and only some support or
+ * multiple key-value pairs with identical keys. If there are multiple values
+ * for a key, mdbx_get() will only return the first value.
+ *
+ * When multiple values for one key are required, pass the MDBX_DUPSORT flag to
+ * mdbx_dbi_open(). In an MDBX_DUPSORT database, by default mdbx_put() will not
+ * replace the value for a key if the key existed already. Instead it will add
+ * the new value to the key. In addition, mdbx_del() will pay attention to the
+ * value field too, allowing for specific values of a key to be deleted.
+ *
+ * Finally, additional cursor operations become available for traversing through
+ * and retrieving duplicate values.
+ *
+ *
+ * SOME OPTIMIZATION
+ *
+ * If you frequently begin and abort read-only transactions, as an optimization,
+ * it is possible to only reset and renew a transaction.
+ *
+ * mdbx_txn_reset() releases any old copies of data kept around for a read-only
+ * transaction. To reuse this reset transaction, call mdbx_txn_renew() on it.
+ * Any cursors in this transaction can also be renewed using mdbx_cursor_renew()
+ * or freed by mdbx_cursor_close().
+ *
+ * To permanently free a transaction, reset or not, use mdbx_txn_abort().
+ *
+ *
+ * CLEANING UP
+ *
+ * Any created cursors must be closed using mdbx_cursor_close(). It is advisable
+ * to repeat:
+ * (!) An important difference between MDBX and LMDB is that MDBX required that
+ * any opened cursors can be reused and must be freed explicitly, regardless
+ * ones was opened in a read-only or write transaction. The REASON for this is
+ * eliminates ambiguity which helps to avoid errors such as: use-after-free,
+ * double-free, i.e. memory corruption and segfaults.
+ *
+ * It is very rarely necessary to close a database handle, and in general they
+ * should just be left open. When you close a handle, it immediately becomes
+ * unavailable for all transactions in the environment. Therefore, you should
+ * avoid closing the handle while at least one transaction is using it.
+ *
+ *
+ * THE FULL API
+ *
+ * The full MDBX documentation lists further details below,
+ * like how to:
+ *
+ * - configure database size and automatic size management
+ * - drop and clean a database
+ * - detect and report errors
+ * - optimize (bulk) loading speed
+ * - (temporarily) reduce robustness to gain even more speed
+ * - gather statistics about the database
+ * - define custom sort orders
+ * - estimate size of range query result
+ * - double perfomance by LIFO reclaiming on storages with write-back
+ * - use sequences and canary markers
+ * - use lack-of-space callback (aka OOM-KICK)
+ * - use exclusive mode
+ *
+ *
+ **** RESTRICTIONS & CAVEATS ***************************************************
+ * in addition to those listed for some functions.
+ *
+ * - Troubleshooting the LCK-file.
+ * 1. A broken LCK-file can cause sync issues, including appearance of
+ * wrong/inconsistent data for readers. When database opened in the
+ * cooperative read-write mode the LCK-file requires to be mapped to
+ * memory in read-write access. In this case it is always possible for
+ * stray/malfunctioned application could writes thru pointers to
+ * silently corrupt the LCK-file.
+ *
+ * Unfortunately, there is no any portable way to prevent such
+ * corruption, since the LCK-file is updated concurrently by
+ * multiple processes in a lock-free manner and any locking is
+ * unwise due to a large overhead.
+ *
+ * The "next" version of libmdbx (MithrilDB) will solve this issue.
+ *
+ * Workaround: Just make all programs using the database close it;
+ * the LCK-file is always reset on first open.
+ *
+ * 2. Stale reader transactions left behind by an aborted program cause
+ * further writes to grow the database quickly, and stale locks can
+ * block further operation.
+ * MDBX checks for stale readers while opening environment and before
+ * growth the database. But in some cases, this may not be enough.
+ *
+ * Workaround: Check for stale readers periodically, using the
+ * mdbx_reader_check() function or the mdbx_stat tool.
+ *
+ * 3. Stale writers will be cleared automatically by MDBX on supprted
+ * platforms. But this is platform-specific, especially of
+ * implementation of shared POSIX-mutexes and support for robust
+ * mutexes. For instance there are no known issues on Linux, OSX,
+ * Windows and FreeBSD.
+ *
+ * Workaround: Otherwise just make all programs using the database
+ * close it; the LCK-file is always reset on first open
+ * of the environment.
+ *
+ * - Do not use MDBX databases on remote filesystems, even between processes
+ * on the same host. This breaks file locks on some platforms, possibly
+ * memory map sync, and certainly sync between programs on different hosts.
+ *
+ * On the other hand, MDBX support the exclusive database operation over
+ * a network, and cooperative read-only access to the database placed on
+ * a read-only network shares.
+ *
+ * - Do not use opened MDBX_env instance(s) in a child processes after fork().
+ * It would be insane to call fork() and any MDBX-functions simultaneously
+ * from multiple threads. The best way is to prevent the presence of open
+ * MDBX-instances during fork().
+ *
+ * The MDBX_TXN_CHECKPID build-time option, which is ON by default on
+ * non-Windows platforms (i.e. where fork() is available), enables PID
+ * checking at a few critical points. But this does not give any guarantees,
+ * but only allows you to detect such errors a little sooner. Depending on
+ * the platform, you should expect an application crash and/or database
+ * corruption in such cases.
+ *
+ * On the other hand, MDBX allow calling mdbx_close_env() in such cases to
+ * release resources, but no more and in general this is a wrong way.
+ *
+ * - There is no pure read-only mode in a normal explicitly way, since
+ * readers need write access to LCK-file to be ones visible for writer.
+ * MDBX always tries to open/create LCK-file for read-write, but switches
+ * to without-LCK mode on appropriate errors (EROFS, EACCESS, EPERM)
+ * if the read-only mode was requested by the MDBX_RDONLY flag which is
+ * described below.
+ *
+ * The "next" version of libmdbx (MithrilDB) will solve this issue.
+ *
+ * - A thread can only use one transaction at a time, plus any nested
+ * read-write transactions in the non-writemap mode. Each transaction
+ * belongs to one thread. The MDBX_NOTLS flag changes this for read-only
+ * transactions. See below.
+ *
+ * - Do not have open an MDBX database twice in the same process at the same
+ * time. By default MDBX prevent this in most cases by tracking databases
+ * opening and return MDBX_BUSY if anyone LCK-file is already open.
+ *
+ * The reason for this is that when the "Open file description" locks (aka
+ * OFD-locks) are not available, MDBX uses POSIX locks on files, and these
+ * locks have issues if one process opens a file multiple times. If a single
+ * process opens the same environment multiple times, closing it once will
+ * remove all the locks held on it, and the other instances will be
+ * vulnerable to corruption from other processes.
+ *
+ * For compatibility with LMDB which allows multi-opening, MDBX can be
+ * configured at runtime by mdbx_setup_debug(MDBX_DBG_LEGACY_MULTIOPEN, ...)
+ * prior to calling other MDBX funcitons. In this way MDBX will track
+ * databases opening, detect multi-opening cases and then recover POSIX file
+ * locks as necessary. However, lock recovery can cause unexpected pauses,
+ * such as when another process opened the database in exclusive mode before
+ * the lock was restored - we have to wait until such a process releases the
+ * database, and so on.
+ *
+ * - Avoid long-lived transactions, especially in the scenarios with a high
+ * rate of write transactions. Read transactions prevent reuse of pages
+ * freed by newer write transactions, thus the database can grow quickly.
+ * Write transactions prevent other write transactions, since writes are
+ * serialized.
+ *
+ * Understanding the problem of long-lived read transactions requires some
+ * explanation, but can be difficult for quick perception. So is is
+ * reasonable to simplify this as follows:
+ * 1. Garbage collection problem exists in all databases one way or
+ * another, e.g. VACUUM in PostgreSQL. But in _libmdbx_ it's even more
+ * discernible because of high transaction rate and intentional
+ * internals simplification in favor of performance.
+ *
+ * 2. MDBX employs Multiversion concurrency control on the Copy-on-Write
+ * basis, that allows multiple readers runs in parallel with a write
+ * transaction without blocking. An each write transaction needs free
+ * pages to put the changed data, that pages will be placed in the new
+ * b-tree snapshot at commit. MDBX efficiently recycling pages from
+ * previous created unused snapshots, BUT this is impossible if anyone
+ * a read transaction use such snapshot.
+ *
+ * 3. Thus massive altering of data during a parallel long read operation
+ * will increase the process's work set and may exhaust entire free
+ * database space.
+ *
+ * A good example of long readers is a hot backup to the slow destination
+ * or debugging of a client application while retaining an active read
+ * transaction. LMDB this results in MAP_FULL error and subsequent write
+ * performance degradation.
+ *
+ * MDBX mostly solve "long-lived" readers issue by the lack-of-space callback
+ * which allow to aborts long readers, and by the MDBX_LIFORECLAIM mode which
+ * addresses subsequent performance degradation.
+ * The "next" version of libmdbx (MithrilDB) will completely solve this.
+ *
+ * - Avoid suspending a process with active transactions. These would then be
+ * "long-lived" as above.
+ *
+ * The "next" version of libmdbx (MithrilDB) will solve this issue.
+ *
+ * - Avoid aborting a process with an active read-only transaction in scenaries
+ * with high rate of write transactions. The transaction becomes "long-lived"
+ * as above until a check for stale readers is performed or the LCK-file is
+ * reset, since the process may not remove it from the lockfile. This does
+ * not apply to write transactions if the system clears stale writers, see
+ * above.
+ *
+ * - An MDBX database configuration will often reserve considerable unused
+ * memory address space and maybe file size for future growth. This does
+ * not use actual memory or disk space, but users may need to understand
+ * the difference so they won't be scared off.
+ *
+ * - The Write Amplification Factor.
+ * TBD.
+ *
+ **** LICENSE AND COPYRUSTING **************************************************
+ *
+ * Copyright 2015-2019 Leonid Yuriev
+ * and other libmdbx authors: please see AUTHORS file.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted only as authorized by the OpenLDAP
+ * Public License.
+ *
+ * A copy of this license is available in the file LICENSE in the
+ * top-level directory of the distribution or, alternatively, at
+ * .
+ *
+ * ---
+ *
+ * This code is derived from "LMDB engine" written by
+ * Howard Chu (Symas Corporation), which itself derived from btree.c
+ * written by Martin Hedenfalk.
+ *
+ * ---
+ *
+ * Portions Copyright 2011-2015 Howard Chu, Symas Corp. All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted only as authorized by the OpenLDAP
+ * Public License.
+ *
+ * A copy of this license is available in the file LICENSE in the
+ * top-level directory of the distribution or, alternatively, at
+ * .
+ *
+ * ---
+ *
+ * Portions Copyright (c) 2009, 2010 Martin Hedenfalk
+ *
+ * Permission to use, copy, modify, and distribute this software for any
+ * purpose with or without fee is hereby granted, provided that the above
+ * copyright notice and this permission notice appear in all copies.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+ * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+ * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+ * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+ * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+ *
+ **** ACKNOWLEDGEMENTS *********************************************************
+ *
+ * Howard Chu (Symas Corporation) - the author of LMDB,
+ * from which originated the MDBX in 2015.
+ *
+ * Martin Hedenfalk - the author of `btree.c` code,
+ * which was used for begin development of LMDB.
+ *
+ ******************************************************************************/
+
+#pragma once
+#ifndef LIBMDBX_H
+#define LIBMDBX_H
+
+#ifdef _MSC_VER
+#pragma warning(push, 1)
+#pragma warning(disable : 4548) /* expression before comma has no effect; \
+ expected expression with side - effect */
+#pragma warning(disable : 4530) /* C++ exception handler used, but unwind \
+ * semantics are not enabled. Specify /EHsc */
+#pragma warning(disable : 4577) /* 'noexcept' used with no exception handling \
+ * mode specified; termination on exception is \
+ * not guaranteed. Specify /EHsc */
+#endif /* _MSC_VER (warnings) */
+
+#include
+#include
+#include
+
+#if defined(_WIN32) || defined(_WIN64)
+
+#include
+#include
+#ifndef __mode_t_defined
+typedef unsigned short mode_t;
+#endif
+typedef HANDLE mdbx_filehandle_t;
+typedef DWORD mdbx_pid_t;
+typedef DWORD mdbx_tid_t;
+#define MDBX_ENODATA ERROR_HANDLE_EOF
+#define MDBX_EINVAL ERROR_INVALID_PARAMETER
+#define MDBX_EACCESS ERROR_ACCESS_DENIED
+#define MDBX_ENOMEM ERROR_OUTOFMEMORY
+#define MDBX_EROFS ERROR_FILE_READ_ONLY
+#define MDBX_ENOSYS ERROR_NOT_SUPPORTED
+#define MDBX_EIO ERROR_WRITE_FAULT
+#define MDBX_EPERM ERROR_INVALID_FUNCTION
+#define MDBX_EINTR ERROR_CANCELLED
+#define MDBX_ENOFILE ERROR_FILE_NOT_FOUND
+
+#else
+
+#include /* for error codes */
+#include /* for pthread_t */
+#include /* for pid_t */
+#include /* for truct iovec */
+#define HAVE_STRUCT_IOVEC 1
+typedef int mdbx_filehandle_t;
+typedef pid_t mdbx_pid_t;
+typedef pthread_t mdbx_tid_t;
+#ifdef ENODATA
+#define MDBX_ENODATA ENODATA
+#else
+#define MDBX_ENODATA -1
+#endif
+#define MDBX_EINVAL EINVAL
+#define MDBX_EACCESS EACCES
+#define MDBX_ENOMEM ENOMEM
+#define MDBX_EROFS EROFS
+#define MDBX_ENOSYS ENOSYS
+#define MDBX_EIO EIO
+#define MDBX_EPERM EPERM
+#define MDBX_EINTR EINTR
+#define MDBX_ENOFILE ENOENT
+
+#endif
+
+#ifdef _MSC_VER
+#pragma warning(pop)
+#endif
+
+/*----------------------------------------------------------------------------*/
+
+#ifndef __has_attribute
+#define __has_attribute(x) (0)
+#endif
+
+#ifndef __dll_export
+#if defined(_WIN32) || defined(__CYGWIN__)
+#if defined(__GNUC__) || __has_attribute(dllexport)
+#define __dll_export __attribute__((dllexport))
+#elif defined(_MSC_VER)
+#define __dll_export __declspec(dllexport)
+#else
+#define __dll_export
+#endif
+#elif defined(__GNUC__) || __has_attribute(__visibility__)
+#define __dll_export __attribute__((__visibility__("default")))
+#else
+#define __dll_export
+#endif
+#endif /* __dll_export */
+
+#ifndef __dll_import
+#if defined(_WIN32) || defined(__CYGWIN__)
+#if defined(__GNUC__) || __has_attribute(dllimport)
+#define __dll_import __attribute__((dllimport))
+#elif defined(_MSC_VER)
+#define __dll_import __declspec(dllimport)
+#else
+#define __dll_import
+#endif
+#else
+#define __dll_import
+#endif
+#endif /* __dll_import */
+
+/*----------------------------------------------------------------------------*/
+
+#define MDBX_VERSION_MAJOR 0
+#define MDBX_VERSION_MINOR 3
+
+#ifndef LIBMDBX_API
+#if defined(LIBMDBX_EXPORTS)
+#define LIBMDBX_API __dll_export
+#elif defined(LIBMDBX_IMPORTS)
+#define LIBMDBX_API __dll_import
+#else
+#define LIBMDBX_API
+#endif
+#endif /* LIBMDBX_API */
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**** MDBX version information ************************************************/
+
+#if defined(LIBMDBX_IMPORTS)
+#define LIBMDBX_VERINFO_API __dll_import
+#else
+#define LIBMDBX_VERINFO_API __dll_export
+#endif /* LIBMDBX_VERINFO_API */
+
+typedef struct mdbx_version_info {
+ uint8_t major;
+ uint8_t minor;
+ uint16_t release;
+ uint32_t revision;
+ struct /* source info from git */ {
+ const char *datetime /* committer date, strict ISO-8601 format */;
+ const char *tree /* commit hash (hexadecimal digits) */;
+ const char *commit /* tree hash, i.e. digest of the source code */;
+ const char *describe /* git-describe string */;
+ } git;
+ const char *sourcery /* sourcery anchor for pinning */;
+} mdbx_version_info;
+extern LIBMDBX_VERINFO_API const mdbx_version_info mdbx_version;
+
+/* MDBX build information.
+ * WARNING: Some strings could be NULL in case no corresponding information was
+ * provided at build time (i.e. flags). */
+typedef struct mdbx_build_info {
+ const char *datetime /* build timestamp (ISO-8601 or __DATE__ __TIME__) */;
+ const char *target /* cpu/arch-system-config triplet */;
+ const char *options /* mdbx-related options */;
+ const char *compiler /* compiler */;
+ const char *flags /* CFLAGS */;
+} mdbx_build_info;
+extern LIBMDBX_VERINFO_API const mdbx_build_info mdbx_build;
+
+#if defined(_WIN32) || defined(_WIN64)
+#if !MDBX_BUILD_SHARED_LIBRARY
+
+/* MDBX internally uses global and thread local storage destructors to
+ * automatically (de)initialization, releasing reader lock table slots
+ * and so on.
+ *
+ * If MDBX builded as a DLL this is done out-of-the-box by DllEntry() function,
+ * which called automatically by Windows core with passing corresponding reason
+ * argument.
+ *
+ * Otherwise, if MDBX was builded not as a DLL, some black magic
+ * may be required depending of Windows version:
+ * - Modern Windows versions, including Windows Vista and later, provides
+ * support for "TLS Directory" (e.g .CRT$XL[A-Z] sections in executable
+ * or dll file). In this case, MDBX capable of doing all automatically,
+ * and you do not need to call mdbx_dll_handler().
+ * - Obsolete versions of Windows, prior to Windows Vista, REQUIRES calling
+ * mdbx_dll_handler() manually from corresponding DllMain() or WinMain()
+ * of your DLL or application.
+ * - This behavior is under control of the MODX_CONFIG_MANUAL_TLS_CALLBACK
+ * option, which is determined by default according to the target version
+ * of Windows at build time.
+ * But you may override MODX_CONFIG_MANUAL_TLS_CALLBACK in special cases.
+ *
+ * Therefore, building MDBX as a DLL is recommended for all version of Windows.
+ * So, if you doubt, just build MDBX as the separate DLL and don't worry. */
+
+#ifndef MDBX_CONFIG_MANUAL_TLS_CALLBACK
+#if defined(_WIN32_WINNT_VISTA) && WINVER >= _WIN32_WINNT_VISTA
+/* As described above mdbx_dll_handler() is NOT needed forWindows Vista
+ * and later. */
+#define MDBX_CONFIG_MANUAL_TLS_CALLBACK 0
+#else
+/* As described above mdbx_dll_handler() IS REQUIRED for Windows versions
+ * prior to Windows Vista. */
+#define MDBX_CONFIG_MANUAL_TLS_CALLBACK 1
+#endif
+#endif /* MDBX_CONFIG_MANUAL_TLS_CALLBACK */
+
+#if MDBX_CONFIG_MANUAL_TLS_CALLBACK
+void LIBMDBX_API NTAPI mdbx_dll_handler(PVOID module, DWORD reason,
+ PVOID reserved);
+#endif /* MDBX_CONFIG_MANUAL_TLS_CALLBACK */
+#endif /* !MDBX_BUILD_SHARED_LIBRARY */
+#endif /* Windows */
+
+/**** OPACITY STRUCTURES ******************************************************/
+
+/* Opaque structure for a database environment.
+ *
+ * An environment supports multiple key-value databases (aka key-value spaces
+ * or tables), all residing in the same shared-memory map. */
+typedef struct MDBX_env MDBX_env;
+
+/* Opaque structure for a transaction handle.
+ *
+ * All database operations require a transaction handle. Transactions may be
+ * read-only or read-write. */
+typedef struct MDBX_txn MDBX_txn;
+
+/* A handle for an individual database (key-value spaces) in the environment.
+ * Zero handle is used internally (hidden Garbage Collection DB).
+ * So, any valid DBI-handle great than 0 and less than or equal MDBX_MAX_DBI. */
+typedef uint32_t MDBX_dbi;
+#define MDBX_MAX_DBI UINT32_C(32765)
+
+/* Opaque structure for navigating through a database */
+typedef struct MDBX_cursor MDBX_cursor;
+
+/* Generic structure used for passing keys and data in and out of the database.
+ *
+ * Values returned from the database are valid only until a subsequent
+ * update operation, or the end of the transaction. Do not modify or
+ * free them, they commonly point into the database itself.
+ *
+ * Key sizes must be between 0 and mdbx_env_get_maxkeysize() inclusive.
+ * The same applies to data sizes in databases with the MDBX_DUPSORT flag.
+ * Other data items can in theory be from 0 to 0x7fffffff bytes long.
+ *
+ * (!) The notable difference between MDBX and LMDB is that MDBX support zero
+ * length keys. */
+#ifndef HAVE_STRUCT_IOVEC
+struct iovec {
+ void *iov_base /* pointer to some data */;
+ size_t iov_len /* the length of data in bytes */;
+};
+#define HAVE_STRUCT_IOVEC
+#endif /* HAVE_STRUCT_IOVEC */
+
+typedef struct iovec MDBX_val;
+
+/* The maximum size of a data item.
+ * MDBX only store a 32 bit value for node sizes. */
+#define MDBX_MAXDATASIZE INT32_MAX
+
+/**** DEBUG & LOGGING **********************************************************
+ * Logging and runtime debug flags.
+ *
+ * NOTE: Most of debug feature enabled only when libmdbx builded with
+ * MDBX_DEBUG options.
+ */
+
+/* Log level (requires build libmdbx with MDBX_DEBUG) */
+#define MDBX_LOG_FATAL 0 /* critical conditions, i.e. assertion failures */
+#define MDBX_LOG_ERROR 1 /* error conditions */
+#define MDBX_LOG_WARN 2 /* warning conditions */
+#define MDBX_LOG_NOTICE 3 /* normal but significant condition */
+#define MDBX_LOG_VERBOSE 4 /* verbose informational */
+#define MDBX_LOG_DEBUG 5 /* debug-level messages */
+#define MDBX_LOG_TRACE 6 /* trace debug-level messages */
+#define MDBX_LOG_EXTRA 7 /* extra debug-level messages (dump pgno lists) */
+
+/* Runtime debug flags.
+ *
+ * MDBX_DBG_DUMP and MDBX_DBG_LEGACY_MULTIOPEN always have an effect,
+ * but MDBX_DBG_ASSERT, MDBX_DBG_AUDIT and MDBX_DBG_JITTER only if libmdbx
+ * builded with MDBX_DEBUG. */
+
+#define MDBX_DBG_ASSERT 1 /* Enable assertion checks */
+#define MDBX_DBG_AUDIT 2 /* Enable pages usage audit at commit transactions */
+#define MDBX_DBG_JITTER 4 /* Enable small random delays in critical points */
+#define MDBX_DBG_DUMP 8 /* Include or not database(s) in coredump files */
+#define MDBX_DBG_LEGACY_MULTIOPEN 16 /* Enable multi-opening environment(s) */
+
+/* A debug-logger callback function,
+ * called before printing the message and aborting.
+ *
+ * [in] env An environment handle returned by mdbx_env_create().
+ * [in] msg The assertion message, not including newline. */
+typedef void MDBX_debug_func(int loglevel, const char *function, int line,
+ const char *msg, va_list args);
+
+/* FIXME: Complete description */
+LIBMDBX_API int mdbx_setup_debug(int loglevel, int flags,
+ MDBX_debug_func *logger);
+
+/* A callback function for most MDBX assert() failures,
+ * called before printing the message and aborting.
+ *
+ * [in] env An environment handle returned by mdbx_env_create().
+ * [in] msg The assertion message, not including newline. */
+typedef void MDBX_assert_func(const MDBX_env *env, const char *msg,
+ const char *function, unsigned line);
+
+/* Set or reset the assert() callback of the environment.
+ *
+ * Does nothing if libmdbx was built with MDBX_DEBUG=0 or with NDEBUG,
+ * and will return MDBX_ENOSYS in such case.
+ *
+ * [in] env An environment handle returned by mdbx_env_create().
+ * [in] func An MDBX_assert_func function, or 0.
+ *
+ * Returns A non-zero error value on failure and 0 on success. */
+LIBMDBX_API int mdbx_env_set_assert(MDBX_env *env, MDBX_assert_func *func);
+
+/* FIXME: Complete description */
+LIBMDBX_API const char *mdbx_dump_val(const MDBX_val *key, char *const buf,
+ const size_t bufsize);
+
+/**** THE FILES ****************************************************************
+ * At the file system level, the environment corresponds to a pair of files. */
+
+/* The name of the lock file in the environment */
+#define MDBX_LOCKNAME "/mdbx.lck"
+/* The name of the data file in the environment */
+#define MDBX_DATANAME "/mdbx.dat"
+
+/* The suffix of the lock file when MDBX_NOSUBDIR is used */
+#define MDBX_LOCK_SUFFIX "-lck"
+
+/**** ENVIRONMENT FLAGS *******************************************************/
+
+/* MDBX_NOSUBDIR = no environment directory.
+ *
+ * By default, MDBX creates its environment in a directory whose pathname is
+ * given in path, and creates its data and lock files under that directory.
+ * With this option, path is used as-is for the database main data file.
+ * The database lock file is the path with "-lck" appended.
+ *
+ * - with MDBX_NOSUBDIR = in a filesystem we have the pair of MDBX-files which
+ * names derived from given pathname by appending predefined suffixes.
+ *
+ * - without MDBX_NOSUBDIR = in a filesystem we have the MDBX-directory with
+ * given pathname, within that a pair of MDBX-files with predefined names.
+ *
+ * This flag affects only at environment opening and can't be changed after. */
+#define MDBX_NOSUBDIR 0x4000u
+
+/* MDBX_RDONLY = read only mode.
+ *
+ * Open the environment in read-only mode. No write operations will be allowed.
+ * MDBX will still modify the lock file - except on read-only filesystems,
+ * where MDBX does not use locks.
+ *
+ * - with MDBX_RDONLY = open environment in read-only mode.
+ * MDBX supports pure read-only mode (i.e. without opening LCK-file) only
+ * when environment directory and/or both files are not writable (and the
+ * LCK-file may be missing). In such case allowing file(s) to be placed
+ * on a network read-only share.
+ *
+ * - without MDBX_RDONLY = open environment in read-write mode.
+ *
+ * This flag affects only at environment opening but can't be changed after. */
+#define MDBX_RDONLY 0x20000u
+
+/* MDBX_EXCLUSIVE = open environment in exclusive/monopolistic mode.
+ *
+ * MDBX_EXCLUSIVE flag can be used as a replacement for MDB_NOLOCK, which don't
+ * supported by MDBX. In this way, you can get the minimal overhead, but with
+ * the correct multi-process and mutli-thread locking.
+ *
+ * - with MDBX_EXCLUSIVE = open environment in exclusive/monopolistic mode
+ * or return MDBX_BUSY if environment already used by other process.
+ * The main feature of the exclusive mode is the ability to open the
+ * environment placed on a network share.
+ *
+ * - without MDBX_EXCLUSIVE = open environment in cooperative mode,
+ * i.e. for multi-process access/interaction/cooperation.
+ * The main requirements of the cooperative mode are:
+ * 1. data files MUST be placed in the LOCAL file system,
+ * but NOT on a network share.
+ * 2. environment MUST be opened only by LOCAL processes,
+ * but NOT over a network.
+ * 3. OS kernel (i.e. file system and memory mapping implementation) and
+ * all processes that open the given environment MUST be running
+ * in the physically single RAM with cache-coherency. The only
+ * exception for cache-consistency requirement is Linux on MIPS
+ * architecture, but this case has not been tested for a long time).
+
+ * This flag affects only at environment opening but can't be changed after. */
+#define MDBX_EXCLUSIVE 0x400000u
+
+/* MDBX_WRITEMAP = map data into memory with write permission.
+ *
+ * Use a writeable memory map unless MDBX_RDONLY is set. This uses fewer mallocs
+ * and requires much less work for tracking database pages, but loses protection
+ * from application bugs like wild pointer writes and other bad updates into the
+ * database. This may be slightly faster for DBs that fit entirely in RAM, but
+ * is slower for DBs larger than RAM. Also adds the possibility for stray
+ * application writes thru pointers to silently corrupt the database.
+ * Incompatible with nested transactions.
+ *
+ * NOTE: The MDBX_WRITEMAP mode is incompatible with nested transactions, since
+ * this is unreasonable. I.e. nested transactions requires mallocation of
+ * database pages and more work for tracking ones, which neuters a
+ * performance boost caused by the MDBX_WRITEMAP mode.
+ *
+ * NOTE: MDBX don't allow to mix processes with and without MDBX_WRITEMAP on
+ * the same environment. In such case MDBX_INCOMPATIBLE will be generated.
+ *
+ * - with MDBX_WRITEMAP = all data will be mapped into memory in the read-write
+ * mode. This offers a significant performance benefit, since the data will
+ * be modified directly in mapped memory and then flushed to disk by
+ * single system call, without any memory management nor copying.
+ * (!) On the other hand, MDBX_WRITEMAP adds the possibility for stray
+ * application writes thru pointers to silently corrupt the database.
+ * Moreover, MDBX_WRITEMAP disallows nested write transactions.
+ *
+ * - without MDBX_WRITEMAP = data will be mapped into memory in the read-only
+ * mode. This requires stocking all modified database pages in memory and
+ * then writing them to disk through file operations.
+ *
+ * This flag affects only at environment opening but can't be changed after. */
+#define MDBX_WRITEMAP 0x80000u
+
+/* MDBX_NOTLS = tie reader locktable slots to read-only transactions instead
+ * of to threads.
+ *
+ * Don't use Thread-Local Storage, instead tie reader locktable slots to
+ * MDBX_txn objects instead of to threads. So, mdbx_txn_reset() keeps the slot
+ * reserved for the MDBX_txn object. A thread may use parallel read-only
+ * transactions. And a read-only transaction may span threads if you
+ * synchronizes its use.
+ *
+ * Applications that multiplex many user threads over individual OS threads need
+ * this option. Such an application must also serialize the write transactions
+ * in an OS thread, since MDBX's write locking is unaware of the user threads.
+ *
+ * NOTE: Regardless to MDBX_NOTLS flag a write transaction entirely should
+ * always be used in one thread from start to finish. MDBX checks this in a
+ * reasonable manner and return the MDBX_THREAD_MISMATCH error in rules
+ * violation.
+ *
+ * This flag affects only at environment opening but can't be changed after. */
+#define MDBX_NOTLS 0x200000u
+
+/* MDBX_NORDAHEAD = don't do readahead.
+ *
+ * Turn off readahead. Most operating systems perform readahead on read requests
+ * by default. This option turns it off if the OS supports it. Turning it off
+ * may help random read performance when the DB is larger than RAM and system
+ * RAM is full.
+ *
+ * NOTE: The mdbx_is_readahead_reasonable() function allows to quickly find out
+ * whether to use readahead or not based on the size of the data and the
+ * amount of available memory.
+ *
+ * This flag affects only at environment opening and can't be changed after. */
+#define MDBX_NORDAHEAD 0x800000u
+
+/* MDBX_NOMEMINIT = don't initialize malloc'd memory before writing to datafile.
+ *
+ * Don't initialize malloc'd memory before writing to unused spaces in the data
+ * file. By default, memory for pages written to the data file is obtained using
+ * malloc. While these pages may be reused in subsequent transactions, freshly
+ * malloc'd pages will be initialized to zeroes before use. This avoids
+ * persisting leftover data from other code (that used the heap and subsequently
+ * freed the memory) into the data file.
+ *
+ * Note that many other system libraries may allocate and free memory from the
+ * heap for arbitrary uses. E.g., stdio may use the heap for file I/O buffers.
+ * This initialization step has a modest performance cost so some applications
+ * may want to disable it using this flag. This option can be a problem for
+ * applications which handle sensitive data like passwords, and it makes memory
+ * checkers like Valgrind noisy. This flag is not needed with MDBX_WRITEMAP,
+ * which writes directly to the mmap instead of using malloc for pages. The
+ * initialization is also skipped if MDBX_RESERVE is used; the caller is
+ * expected to overwrite all of the memory that was reserved in that case.
+ *
+ * This flag may be changed at any time using mdbx_env_set_flags(). */
+#define MDBX_NOMEMINIT 0x1000000u
+
+/* MDBX_COALESCE = aims to coalesce a Garbage Collection items.
+ *
+ * With MDBX_COALESCE flag MDBX will aims to coalesce items while recycling
+ * a Garbage Collection. Technically, when possible short lists of pages will
+ * be combined into longer ones, but to fit on one database page. As a result,
+ * there will be fewer items in Garbage Collection and a page lists are longer,
+ * which slightly increases the likelihood of returning pages to Unallocated
+ * space and reducing the database file.
+ *
+ * This flag may be changed at any time using mdbx_env_set_flags(). */
+#define MDBX_COALESCE 0x2000000u
+
+/* MDBX_LIFORECLAIM = LIFO policy for recycling a Garbage Collection items.
+ *
+ * MDBX_LIFORECLAIM flag turns on LIFO policy for recycling a Garbage
+ * Collection items, instead of FIFO by default. On systems with a disk
+ * write-back cache, this can significantly increase write performance, up to
+ * several times in a best case scenario.
+ *
+ * LIFO recycling policy means that for reuse pages will be taken which became
+ * unused the lastest (i.e. just now or most recently). Therefore the loop of
+ * database pages circulation becomes as short as possible. In other words, the
+ * number of pages, that are overwritten in memory and on disk during a series
+ * of write transactions, will be as small as possible. Thus creates ideal
+ * conditions for the efficient operation of the disk write-back cache.
+ *
+ * MDBX_LIFORECLAIM is compatible with all no-sync flags (i.e. MDBX_NOMETASYNC,
+ * MDBX_NOSYNC, MDBX_UTTERLY_NOSYNC, MDBX_MAPASYNC), but gives no noticeable
+ * impact in combination with MDB_NOSYNC and MDX_MAPASYNC. Because MDBX will
+ * not reused paged from the last "steady" MVCC-snapshot and later, i.e. the
+ * loop length of database pages circulation will be mostly defined by frequency
+ * of calling mdbx_env_sync() rather than LIFO and FIFO difference.
+ *
+ * This flag may be changed at any time using mdbx_env_set_flags(). */
+#define MDBX_LIFORECLAIM 0x4000000u
+
+/* Debuging option, fill/perturb released pages. */
+#define MDBX_PAGEPERTURB 0x8000000u
+
+/**** SYNC MODES ***************************************************************
+ * (!!!) Using any combination of MDBX_NOSYNC, MDBX_NOMETASYNC, MDBX_MAPASYNC
+ * and especially MDBX_UTTERLY_NOSYNC is always a deal to reduce durability
+ * for gain write performance. You must know exactly what you are doing and
+ * what risks you are taking!
+ *
+ * NOTE for LMDB users: MDBX_NOSYNC is NOT similar to LMDB_NOSYNC, but
+ * MDBX_UTTERLY_NOSYNC is exactly match LMDB_NOSYNC.
+ * See details below.
+ *
+ * THE SCENE:
+ * - The DAT-file contains several MVCC-snapshots of B-tree at same time,
+ * each of those B-tree has its own root page.
+ * - Each of meta pages at the beginning of the DAT file contains a pointer
+ * to the root page of B-tree which is the result of the particular
+ * transaction, and a number of this transaction.
+ * - For data durability, MDBX must first write all MVCC-snapshot data pages
+ * and ensure that are written to the disk, then update a meta page with
+ * the new transaction number and a pointer to the corresponding new root
+ * page, and flush any buffers yet again.
+ * - Thus during commit a I/O buffers should be flushed to the disk twice;
+ * i.e. fdatasync(), FlushFileBuffers() or similar syscall should be called
+ * twice for each commit. This is very expensive for performance, but
+ * guaranteed durability even on unexpected system failure or power outage.
+ * Of course, provided that the operating system and the underlying hardware
+ * (e.g. disk) work correctly.
+ *
+ * TRADE-OFF: By skipping some stages described above, you can significantly
+ * benefit in speed, while partially or completely losing in the guarantee of
+ * data durability and/or consistency in the event of system or power failure.
+ * Moreover, if for any reason disk write order is not preserved, then at moment
+ * of a system crash, a meta-page with a pointer to the new B-tree may be
+ * written to disk, while the itself B-tree not yet. In that case, the database
+ * will be corrupted!
+ *
+ *
+ * MDBX_NOMETASYNC = don't sync the meta-page after commit.
+ *
+ * Flush system buffers to disk only once per transaction, omit the
+ * metadata flush. Defer that until the system flushes files to disk,
+ * or next non-MDBX_RDONLY commit or mdbx_env_sync(). Depending on the
+ * platform and hardware, with MDBX_NOMETASYNC you may get a doubling of
+ * write performance.
+ *
+ * This trade-off maintains database integrity, but a system crash may
+ * undo the last committed transaction. I.e. it preserves the ACI
+ * (atomicity, consistency, isolation) but not D (durability) database
+ * property.
+ *
+ * MDBX_NOMETASYNC flag may be changed at any time using
+ * mdbx_env_set_flags() or by passing to mdbx_txn_begin() for particular
+ * write transaction.
+ *
+ *
+ * MDBX_UTTERLY_NOSYNC = don't sync anything and wipe previous steady commits.
+ *
+ * Don't flush system buffers to disk when committing a transaction. This
+ * optimization means a system crash can corrupt the database, if buffers
+ * are not yet flushed to disk. Depending on the platform and hardware,
+ * with MDBX_UTTERLY_NOSYNC you may get a multiple increase of write
+ * performance, even 100 times or more.
+ *
+ * If the filesystem preserves write order (which is rare and never
+ * provided unless explicitly noted) and the MDBX_WRITEMAP and
+ * MDBX_LIFORECLAIM flags are not used, then a system crash can't corrupt
+ * the database, but you can lose the last transactions, if at least one
+ * buffer is not yet flushed to disk. The risk is governed by how often the
+ * system flushes dirty buffers to disk and how often mdbx_env_sync() is
+ * called. So, transactions exhibit ACI (atomicity, consistency, isolation)
+ * properties and only lose D (durability). I.e. database integrity is
+ * maintained, but a system crash may undo the final transactions.
+ *
+ * Otherwise, if the filesystem not preserves write order (which is
+ * typically) or MDBX_WRITEMAP or MDBX_LIFORECLAIM flags are used, you
+ * should expect the corrupted database after a system crash.
+ *
+ * So, most important thing about MDBX_UTTERLY_NOSYNC:
+ * - a system crash immediately after commit the write transaction
+ * high likely lead to database corruption.
+ * - successful completion of mdbx_env_sync(force = true) after one or
+ * more commited transactions guarantees consystency and durability.
+ * - BUT by committing two or more transactions you back database into a
+ * weak state, in which a system crash may lead to database corruption!
+ * In case single transaction after mdbx_env_sync, you may lose
+ * transaction itself, but not a whole database.
+ *
+ * Nevertheless, MDBX_UTTERLY_NOSYNC provides ACID in case of a application
+ * crash, and therefore may be very useful in scenarios where data
+ * durability is not required over a system failure (e.g for short-lived
+ * data), or if you can ignore such risk.
+ *
+ * MDBX_UTTERLY_NOSYNC flag may be changed at any time using
+ * mdbx_env_set_flags(), but don't has effect if passed to mdbx_txn_begin()
+ * for particular write transaction.
+ *
+ *
+ * MDBX_NOSYNC = don't sync anything but keep previous steady commits.
+ *
+ * Like MDBX_UTTERLY_NOSYNC the MDBX_NOSYNC flag similarly disable flush
+ * system buffers to disk when committing a transaction. But there is a
+ * huge difference in how are recycled the MVCC snapshots corresponding
+ * to previous "steady" transactions (see below).
+ *
+ * Depending on the platform and hardware, with MDBX_NOSYNC you may get
+ * a multiple increase of write performance, even 10 times or more.
+ * NOTE that (MDBX_NOSYNC | MDBX_WRITEMAP) leaves the system with no hint
+ * for when to write transactions to disk. Therefore the (MDBX_MAPASYNC |
+ * MDBX_WRITEMAP) may be preferable, but without MDBX_NOSYNC because
+ * the (MDBX_MAPASYNC | MDBX_NOSYNC) actually gives MDBX_UTTERLY_NOSYNC.
+ *
+ * In contrast to MDBX_UTTERLY_NOSYNC mode, with MDBX_NOSYNC flag MDBX will
+ * keeps untouched pages within B-tree of the last transaction "steady"
+ * which was synced to disk completely. This has big implications for both
+ * data durability and (unfortunately) performance:
+ * - a system crash can't corrupt the database, but you will lose the
+ * last transactions; because MDBX will rollback to last steady commit
+ * since it kept explicitly.
+ * - the last steady transaction makes an effect similar to "long-lived"
+ * read transaction (see above in the "RESTRICTIONS & CAVEATS" section)
+ * since prevents reuse of pages freed by newer write transactions,
+ * thus the any data changes will be placed in newly allocated pages.
+ * - to avoid rapid database growth, the system will sync data and issue
+ * a steady commit-point to resume reuse pages, each time there is
+ * insufficient space and before increasing the size of the file on
+ * disk.
+ *
+ * In other words, with MDBX_NOSYNC flag MDBX insures you from the whole
+ * database corruption, at the cost increasing database size and/or number
+ * of disk IOPS. So, MDBX_NOSYNC flag could be used with mdbx_env_synv()
+ * as alternatively for batch committing or nested transaction (in some
+ * cases). As well, auto-sync feature exposed by mdbx_env_set_syncbytes()
+ * and mdbx_env_set_syncperiod() functions could be very usefull with
+ * MDBX_NOSYNC flag.
+ *
+ * The number and volume of of disk IOPS with MDBX_NOSYNC flag will
+ * exactly the as without any no-sync flags. However, you should expect
+ * a larger process's work set (https://bit.ly/2kA2tFX) and significantly
+ * worse a locality of reference (https://bit.ly/2mbYq2J), due to the
+ * more intensive allocation of previously unused pages and increase the
+ * size of the database.
+ *
+ * MDBX_NOSYNC flag may be changed at any time using
+ * mdbx_env_set_flags() or by passing to mdbx_txn_begin() for particular
+ * write transaction.
+ *
+ *
+ * MDBX_MAPASYNC = use asynchronous msync when MDBX_WRITEMAP is used.
+ *
+ * MDBX_MAPASYNC meaningful and give effect only in conjunction
+ * with MDBX_WRITEMAP or MDBX_NOSYNC:
+ * - with MDBX_NOSYNC actually gives MDBX_UTTERLY_NOSYNC, which
+ * wipe previous steady commits for reuse pages as described above.
+ * - with MDBX_WRITEMAP but without MDBX_NOSYNC instructs MDBX to use
+ * asynchronous mmap-flushes to disk as described below.
+ * - with both MDBX_WRITEMAP and MDBX_NOSYNC you get the both effects.
+ *
+ * Asynchronous mmap-flushes means that actually all writes will scheduled
+ * and performed by operation system on it own manner, i.e. unordered.
+ * MDBX itself just notify operating system that it would be nice to write
+ * data to disk, but no more.
+ *
+ * With MDBX_MAPASYNC flag, but without MDBX_UTTERLY_NOSYNC (i.e. without
+ * OR'ing with MDBX_NOSYNC) MDBX will keeps untouched pages within B-tree
+ * of the last transaction "steady" which was synced to disk completely.
+ * So, this makes exactly the same "long-lived" impact and the same
+ * consequences as described above for MDBX_NOSYNC flag.
+ *
+ * Depending on the platform and hardware, with combination of
+ * MDBX_WRITEMAP and MDBX_MAPASYNC you may get a multiple increase of write
+ * performance, even 25 times or more. MDBX_MAPASYNC flag may be changed at
+ * any time using mdbx_env_set_flags() or by passing to mdbx_txn_begin()
+ * for particular write transaction.
+ */
+
+/* Don't sync meta-page after commit,
+ * see description in the "SYNC MODES" section above. */
+#define MDBX_NOMETASYNC 0x40000u
+
+/* Don't sync anything but keep previous steady commits,
+ * see description in the "SYNC MODES" section above.
+ *
+ * (!) don't combine this flag with MDBX_MAPASYNC
+ * since you will got MDBX_UTTERLY_NOSYNC in that way (see below) */
+#define MDBX_NOSYNC 0x10000u
+
+/* Use asynchronous msync when MDBX_WRITEMAP is used,
+ * see description in the "SYNC MODES" section above.
+ *
+ * (!) don't combine this flag with MDBX_NOSYNC
+ * since you will got MDBX_UTTERLY_NOSYNC in that way (see below) */
+#define MDBX_MAPASYNC 0x100000u
+
+/* Don't sync anything and wipe previous steady commits,
+ * see description in the "SYNC MODES" section above. */
+#define MDBX_UTTERLY_NOSYNC (MDBX_NOSYNC | MDBX_MAPASYNC)
+
+/**** DATABASE FLAGS **********************************************************/
+/* Use reverse string keys */
+#define MDBX_REVERSEKEY 0x02u
+/* Use sorted duplicates */
+#define MDBX_DUPSORT 0x04u
+/* Numeric keys in native byte order, either uint32_t or uint64_t.
+ * The keys must all be of the same size. */
+#define MDBX_INTEGERKEY 0x08u
+/* With MDBX_DUPSORT, sorted dup items have fixed size */
+#define MDBX_DUPFIXED 0x10u
+/* With MDBX_DUPSORT, dups are MDBX_INTEGERKEY-style integers */
+#define MDBX_INTEGERDUP 0x20u
+/* With MDBX_DUPSORT, use reverse string dups */
+#define MDBX_REVERSEDUP 0x40u
+/* Create DB if not already existing */
+#define MDBX_CREATE 0x40000u
+
+/**** DATA UPDATE FLAGS *******************************************************/
+/* For put: Don't write if the key already exists. */
+#define MDBX_NOOVERWRITE 0x10u
+/* Only for MDBX_DUPSORT
+ * For put: don't write if the key and data pair already exist.
+ * For mdbx_cursor_del: remove all duplicate data items. */
+#define MDBX_NODUPDATA 0x20u
+/* For mdbx_cursor_put: overwrite the current key/data pair
+ * MDBX allows this flag for mdbx_put() for explicit overwrite/update without
+ * insertion. */
+#define MDBX_CURRENT 0x40u
+/* For put: Just reserve space for data, don't copy it. Return a
+ * pointer to the reserved space. */
+#define MDBX_RESERVE 0x10000u
+/* Data is being appended, don't split full pages. */
+#define MDBX_APPEND 0x20000u
+/* Duplicate data is being appended, don't split full pages. */
+#define MDBX_APPENDDUP 0x40000u
+/* Store multiple data items in one call. Only for MDBX_DUPFIXED. */
+#define MDBX_MULTIPLE 0x80000u
+
+/**** TRANSACTION FLAGS *******************************************************/
+/* Do not block when starting a write transaction */
+#define MDBX_TRYTXN 0x10000000u
+
+/**** ENVIRONMENT COPY FLAGS **************************************************/
+/* Compacting: Omit free space from copy, and renumber all pages sequentially */
+#define MDBX_CP_COMPACT 1u
+
+/**** CURSOR OPERATIONS ********************************************************
+ *
+ * This is the set of all operations for retrieving data
+ * using a cursor. */
+typedef enum MDBX_cursor_op {
+ MDBX_FIRST, /* Position at first key/data item */
+ MDBX_FIRST_DUP, /* MDBX_DUPSORT-only: Position at first data item
+ * of current key. */
+ MDBX_GET_BOTH, /* MDBX_DUPSORT-only: Position at key/data pair. */
+ MDBX_GET_BOTH_RANGE, /* MDBX_DUPSORT-only: position at key, nearest data. */
+ MDBX_GET_CURRENT, /* Return key/data at current cursor position */
+ MDBX_GET_MULTIPLE, /* MDBX_DUPFIXED-only: Return up to a page of duplicate
+ * data items from current cursor position.
+ * Move cursor to prepare for MDBX_NEXT_MULTIPLE. */
+ MDBX_LAST, /* Position at last key/data item */
+ MDBX_LAST_DUP, /* MDBX_DUPSORT-only: Position at last data item
+ * of current key. */
+ MDBX_NEXT, /* Position at next data item */
+ MDBX_NEXT_DUP, /* MDBX_DUPSORT-only: Position at next data item
+ * of current key. */
+ MDBX_NEXT_MULTIPLE, /* MDBX_DUPFIXED-only: Return up to a page of
+ * duplicate data items from next cursor position.
+ * Move cursor to prepare for MDBX_NEXT_MULTIPLE. */
+ MDBX_NEXT_NODUP, /* Position at first data item of next key */
+ MDBX_PREV, /* Position at previous data item */
+ MDBX_PREV_DUP, /* MDBX_DUPSORT-only: Position at previous data item
+ * of current key. */
+ MDBX_PREV_NODUP, /* Position at last data item of previous key */
+ MDBX_SET, /* Position at specified key */
+ MDBX_SET_KEY, /* Position at specified key, return both key and data */
+ MDBX_SET_RANGE, /* Position at first key greater than or equal to
+ * specified key. */
+ MDBX_PREV_MULTIPLE /* MDBX_DUPFIXED-only: Position at previous page and
+ * return up to a page of duplicate data items. */
+} MDBX_cursor_op;
+
+/**** ERRORS & RETURN CODES ****************************************************
+ * BerkeleyDB uses -30800 to -30999, we'll go under them */
+
+/* Successful result */
+#define MDBX_SUCCESS 0
+#define MDBX_RESULT_FALSE MDBX_SUCCESS
+/* Successful result with special meaning or a flag */
+#define MDBX_RESULT_TRUE (-1)
+
+/* key/data pair already exists */
+#define MDBX_KEYEXIST (-30799)
+/* key/data pair not found (EOF) */
+#define MDBX_NOTFOUND (-30798)
+/* Requested page not found - this usually indicates corruption */
+#define MDBX_PAGE_NOTFOUND (-30797)
+/* Database is corrupted (page was wrong type and so on) */
+#define MDBX_CORRUPTED (-30796)
+/* Environment had fatal error (i.e. update of meta page failed and so on) */
+#define MDBX_PANIC (-30795)
+/* DB file version mismatch with libmdbx */
+#define MDBX_VERSION_MISMATCH (-30794)
+/* File is not a valid MDBX file */
+#define MDBX_INVALID (-30793)
+/* Environment mapsize reached */
+#define MDBX_MAP_FULL (-30792)
+/* Environment maxdbs reached */
+#define MDBX_DBS_FULL (-30791)
+/* Environment maxreaders reached */
+#define MDBX_READERS_FULL (-30790)
+/* Txn has too many dirty pages */
+#define MDBX_TXN_FULL (-30788)
+/* Cursor stack too deep - internal error */
+#define MDBX_CURSOR_FULL (-30787)
+/* Page has not enough space - internal error */
+#define MDBX_PAGE_FULL (-30786)
+/* Database contents grew beyond environment mapsize */
+#define MDBX_MAP_RESIZED (-30785)
+/* Operation and DB incompatible, or DB type changed. This can mean:
+ * - The operation expects an MDBX_DUPSORT / MDBX_DUPFIXED database.
+ * - Opening a named DB when the unnamed DB has MDBX_DUPSORT/MDBX_INTEGERKEY.
+ * - Accessing a data record as a database, or vice versa.
+ * - The database was dropped and recreated with different flags. */
+#define MDBX_INCOMPATIBLE (-30784)
+/* Invalid reuse of reader locktable slot */
+#define MDBX_BAD_RSLOT (-30783)
+/* Transaction must abort, has a child, or is invalid */
+#define MDBX_BAD_TXN (-30782)
+/* Unsupported size of key/DB name/data, or wrong DUPFIXED size */
+#define MDBX_BAD_VALSIZE (-30781)
+/* The specified DBI was changed unexpectedly */
+#define MDBX_BAD_DBI (-30780)
+/* Unexpected problem - txn should abort */
+#define MDBX_PROBLEM (-30779)
+/* Another write transaction is running or environment is already used while
+ * opening with MDBX_EXCLUSIVE flag */
+#define MDBX_BUSY (-30778)
+/* The last defined error code */
+#define MDBX_LAST_ERRCODE MDBX_BUSY
+
+/* The mdbx_put() or mdbx_replace() was called for key,
+ * that has more that one associated value. */
+#define MDBX_EMULTIVAL (-30421)
+
+/* Bad signature of a runtime object(s), this can mean:
+ * - memory corruption or double-free;
+ * - ABI version mismatch (rare case); */
+#define MDBX_EBADSIGN (-30420)
+
+/* Database should be recovered, but this could NOT be done automatically
+ * right now (e.g. in readonly mode and so forth). */
+#define MDBX_WANNA_RECOVERY (-30419)
+
+/* The given key value is mismatched to the current cursor position,
+ * when mdbx_cursor_put() called with MDBX_CURRENT option. */
+#define MDBX_EKEYMISMATCH (-30418)
+
+/* Database is too large for current system,
+ * e.g. could NOT be mapped into RAM. */
+#define MDBX_TOO_LARGE (-30417)
+
+/* A thread has attempted to use a not owned object,
+ * e.g. a transaction that started by another thread. */
+#define MDBX_THREAD_MISMATCH (-30416)
+
+/**** FUNCTIONS & RELATED STRUCTURES ******************************************/
+
+/* Return a string describing a given error code.
+ *
+ * This function is a superset of the ANSI C X3.159-1989 (ANSI C) strerror(3)
+ * function. If the error code is greater than or equal to 0, then the string
+ * returned by the system function strerror(3) is returned. If the error code
+ * is less than 0, an error string corresponding to the MDBX library error is
+ * returned. See errors for a list of MDBX-specific error codes.
+ *
+ * mdbx_strerror() - is NOT thread-safe because may share common internal
+ * buffer for system maessages. The returned string must
+ * NOT be modified by the application, but MAY be modified
+ * by a subsequent call to mdbx_strerror(), strerror() and
+ * other related functions.
+ *
+ * mdbx_strerror_r() - is thread-safe since uses user-supplied buffer where
+ * appropriate. The returned string must NOT be modified
+ * by the application, since it may be pointer to internal
+ * constatn string. However, there is no restriction if the
+ * returned string points to the supplied buffer.
+ *
+ * [in] err The error code.
+ *
+ * Returns "error message" The description of the error. */
+LIBMDBX_API const char *mdbx_strerror(int errnum);
+LIBMDBX_API const char *mdbx_strerror_r(int errnum, char *buf, size_t buflen);
+
+#if defined(_WIN32) || defined(_WIN64)
+/* Bit of Windows' madness. The similar functions but returns Windows
+ * error-messages in the OEM-encoding for console utilities. */
+LIBMDBX_API const char *mdbx_strerror_ANSI2OEM(int errnum);
+LIBMDBX_API const char *mdbx_strerror_r_ANSI2OEM(int errnum, char *buf,
+ size_t buflen);
+#endif /* Bit of Windows' madness */
+
+/* Create an MDBX environment instance.
+ *
+ * This function allocates memory for a MDBX_env structure. To release
+ * the allocated memory and discard the handle, call mdbx_env_close().
+ * Before the handle may be used, it must be opened using mdbx_env_open().
+ *
+ * Various other options may also need to be set before opening the handle,
+ * e.g. mdbx_env_set_geometry(), mdbx_env_set_maxreaders(),
+ * mdbx_env_set_maxdbs(), depending on usage requirements.
+ *
+ * [out] env The address where the new handle will be stored.
+ *
+ * Returns a non-zero error value on failure and 0 on success. */
+LIBMDBX_API int mdbx_env_create(MDBX_env **penv);
+
+/* Open an environment instance.
+ *
+ * Indifferently this function will fails or not, the mdbx_env_close() must be
+ * called later to discard the MDBX_env handle and release associated resources.
+ *
+ * [in] env An environment handle returned by mdbx_env_create()
+ * [in] pathname The directory in which the database files reside.
+ * This directory must already exist and be writable.
+ * [in] flags Special options for this environment. This parameter
+ * must be set to 0 or by bitwise OR'ing together one
+ * or more of the values described above in the
+ * "ENVIRONMENT FLAGS" and "SYNC MODES" sections.
+ *
+ * Flags set by mdbx_env_set_flags() are also used:
+ * - MDBX_NOSUBDIR, MDBX_RDONLY, MDBX_EXCLUSIVE, MDBX_WRITEMAP, MDBX_NOTLS,
+ * MDBX_NORDAHEAD, MDBX_NOMEMINIT, MDBX_COALESCE, MDBX_LIFORECLAIM.
+ * See "ENVIRONMENT FLAGS" section above.
+ *
+ * - MDBX_NOMETASYNC, MDBX_NOSYNC, MDBX_UTTERLY_NOSYNC, MDBX_MAPASYNC.
+ * See "SYNC MODES" section above.
+ *
+ * NOTE: MDB_NOLOCK flag don't supported by MDBX,
+ * try use MDBX_EXCLUSIVE as a replacement.
+ *
+ * NOTE: MDBX don't allow to mix processes with different MDBX_WRITEMAP,
+ * MDBX_NOSYNC, MDBX_NOMETASYNC, MDBX_MAPASYNC flags onthe same
+ * environment. In such case MDBX_INCOMPATIBLE will be returned.
+ *
+ * If the database is already exist and parameters specified early by
+ * mdbx_env_set_geometry() are incompatible (i.e. for instance, different page
+ * size) then mdbx_env_open() will return MDBX_INCOMPATIBLE error.
+ *
+ * [in] mode The UNIX permissions to set on created files. Zero value means
+ * to open existing, but do not create.
+ *
+ * Returns A non-zero error value on failure and 0 on success, some
+ * possible errors are:
+ * - MDBX_VERSION_MISMATCH = the version of the MDBX library doesn't match the
+ * version that created the database environment.
+ * - MDBX_INVALID = the environment file headers are corrupted.
+ * - MDBX_ENOENT = the directory specified by the path parameter
+ * doesn't exist.
+ * - MDBX_EACCES = the user didn't have permission to access
+ * the environment files.
+ * - MDBX_EAGAIN = the environment was locked by another process.
+ * - MDBX_BUSY = MDBX_EXCLUSIVE flag was specified and the
+ * environment is in use by another process,
+ * or the current process tries to open environment
+ * more than once.
+ * - MDBX_INCOMPATIBLE = Environment is already opened by another process,
+ * but with different set of MDBX_WRITEMAP,
+ * MDBX_NOSYNC, MDBX_NOMETASYNC, MDBX_MAPASYNC
+ * flags.
+ * Or if the database is already exist and
+ * parameters specified early by
+ * mdbx_env_set_geometry() are incompatible (i.e.
+ * for instance, different page size).
+ * - MDBX_WANNA_RECOVERY = MDBX_RDONLY flag was specified but read-write
+ * access is required to rollback inconsistent state
+ * after a system crash.
+ * - MDBX_TOO_LARGE = Database is too large for this process, i.e.
+ * 32-bit process tries to open >4Gb database. */
+LIBMDBX_API int mdbx_env_open(MDBX_env *env, const char *pathname,
+ unsigned flags, mode_t mode);
+
+/* Copy an MDBX environment to the specified path, with options.
+ *
+ * This function may be used to make a backup of an existing environment.
+ * No lockfile is created, since it gets recreated at need.
+ * NOTE: This call can trigger significant file size growth if run in
+ * parallel with write transactions, because it employs a read-only
+ * transaction. See long-lived transactions under "Caveats" section.
+ *
+ * [in] env An environment handle returned by mdbx_env_create(). It must
+ * have already been opened successfully.
+ * [in] dest The directory in which the copy will reside. This directory
+ * must already exist and be writable but must otherwise be empty.
+ * [in] flags Special options for this operation. This parameter must be set
+ * to 0 or by bitwise OR'ing together one or more of the values
+ * described here:
+ *
+ * - MDBX_CP_COMPACT
+ * Perform compaction while copying: omit free pages and sequentially
+ * renumber all pages in output. This option consumes little bit more
+ * CPU for processing, but may running quickly than the default, on
+ * account skipping free pages.
+ *
+ * Returns A non-zero error value on failure and 0 on success. */
+LIBMDBX_API int mdbx_env_copy(MDBX_env *env, const char *dest, unsigned flags);
+
+/* Copy an MDBX environment to the specified file descriptor,
+ * with options.
+ *
+ * This function may be used to make a backup of an existing environment.
+ * No lockfile is created, since it gets recreated at need. See
+ * mdbx_env_copy() for further details.
+ *
+ * NOTE: This call can trigger significant file size growth if run in
+ * parallel with write transactions, because it employs a read-only
+ * transaction. See long-lived transactions under "Caveats" section.
+ *
+ * NOTE: Fails if the environment has suffered a page leak and the destination
+ * file descriptor is associated with a pipe, socket, or FIFO.
+ *
+ * [in] env An environment handle returned by mdbx_env_create(). It must
+ * have already been opened successfully.
+ * [in] fd The filedescriptor to write the copy to. It must have already
+ * been opened for Write access.
+ * [in] flags Special options for this operation. See mdbx_env_copy() for
+ * options.
+ *
+ * Returns A non-zero error value on failure and 0 on success. */
+LIBMDBX_API int mdbx_env_copy2fd(MDBX_env *env, mdbx_filehandle_t fd,
+ unsigned flags);
+
+/* Statistics for a database in the environment */
+typedef struct MDBX_stat {
+ uint32_t ms_psize; /* Size of a database page.
+ * This is the same for all databases. */
+ uint32_t ms_depth; /* Depth (height) of the B-tree */
+ uint64_t ms_branch_pages; /* Number of internal (non-leaf) pages */
+ uint64_t ms_leaf_pages; /* Number of leaf pages */
+ uint64_t ms_overflow_pages; /* Number of overflow pages */
+ uint64_t ms_entries; /* Number of data items */
+ uint64_t ms_mod_txnid; /* Transaction ID of commited last modification */
+} MDBX_stat;
+
+/* Return statistics about the MDBX environment.
+ *
+ * At least one of env or txn argument must be non-null. If txn is passed
+ * non-null then stat will be filled accordingly to the given transaction.
+ * Otherwise, if txn is null, then stat will be populated by a snapshot from the
+ * last committed write transaction, and at next time, other information can be
+ * returned.
+ *
+ * Legacy mdbx_env_stat() correspond to calling mdbx_env_stat_ex() with the null
+ * txn argument.
+ *
+ * [in] env An environment handle returned by mdbx_env_create()
+ * [in] txn A transaction handle returned by mdbx_txn_begin()
+ * [out] stat The address of an MDBX_stat structure where the statistics
+ * will be copied
+ *
+ * Returns A non-zero error value on failure and 0 on success. */
+LIBMDBX_API int mdbx_env_stat_ex(const MDBX_env *env, const MDBX_txn *txn,
+ MDBX_stat *stat, size_t bytes);
+LIBMDBX_API int mdbx_env_stat(MDBX_env *env, MDBX_stat *stat, size_t bytes);
+
+/* Information about the environment */
+typedef struct MDBX_envinfo {
+ struct {
+ uint64_t lower; /* lower limit for datafile size */
+ uint64_t upper; /* upper limit for datafile size */
+ uint64_t current; /* current datafile size */
+ uint64_t shrink; /* shrink threshold for datafile */
+ uint64_t grow; /* growth step for datafile */
+ } mi_geo;
+ uint64_t mi_mapsize; /* Size of the data memory map */
+ uint64_t mi_last_pgno; /* ID of the last used page */
+ uint64_t mi_recent_txnid; /* ID of the last committed transaction */
+ uint64_t mi_latter_reader_txnid; /* ID of the last reader transaction */
+ uint64_t mi_self_latter_reader_txnid; /* ID of the last reader transaction of
+ caller process */
+ uint64_t mi_meta0_txnid, mi_meta0_sign;
+ uint64_t mi_meta1_txnid, mi_meta1_sign;
+ uint64_t mi_meta2_txnid, mi_meta2_sign;
+ uint32_t mi_maxreaders; /* max reader slots in the environment */
+ uint32_t mi_numreaders; /* max reader slots used in the environment */
+ uint32_t mi_dxb_pagesize; /* database pagesize */
+ uint32_t mi_sys_pagesize; /* system pagesize */
+
+ uint64_t
+ mi_bootid[2]; /* A mostly unique ID that is regenerated on each boot.
+ As such it can be used to identify the local
+ machine's current boot. MDBX uses such when open
+ the database to determine whether rollback required
+ to the last steady sync point or not. I.e. if current
+ bootid is differ from the value within a database then
+ the system was rebooted and all changes since last steady
+ sync must be reverted for data integrity. Zeros mean that
+ no relevant information is available from the system. */
+ uint64_t mi_unsync_volume; /* bytes not explicitly synchronized to disk */
+ uint64_t mi_autosync_threshold; /* current auto-sync threshold, see
+ mdbx_env_set_syncbytes(). */
+ uint32_t mi_since_sync_seconds16dot16; /* time since the last steady sync in
+ 1/65536 of second */
+ uint32_t mi_autosync_period_seconds16dot16 /* current auto-sync period in
+ 1/65536 of second, see
+ mdbx_env_set_syncperiod(). */
+ ;
+ uint32_t mi_since_reader_check_seconds16dot16; /* time since the last readers
+ check in 1/65536 of second,
+ see mdbx_reader_check(). */
+ uint32_t mi_mode; /* current environment mode, the same as
+ mdbx_env_get_flags() returns. */
+} MDBX_envinfo;
+
+/* Return information about the MDBX environment.
+ *
+ * At least one of env or txn argument must be non-null. If txn is passed
+ * non-null then stat will be filled accordingly to the given transaction.
+ * Otherwise, if txn is null, then stat will be populated by a snapshot from the
+ * last committed write transaction, and at next time, other information can be
+ * returned.
+ *
+ * Legacy mdbx_env_info() correspond to calling mdbx_env_info_ex() with the null
+ * txn argument.
+
+ * [in] env An environment handle returned by mdbx_env_create()
+ * [in] txn A transaction handle returned by mdbx_txn_begin()
+ * [out] stat The address of an MDBX_envinfo structure
+ * where the information will be copied
+ *
+ * Returns A non-zero error value on failure and 0 on success. */
+LIBMDBX_API int mdbx_env_info_ex(const MDBX_env *env, const MDBX_txn *txn,
+ MDBX_envinfo *info, size_t bytes);
+LIBMDBX_API int mdbx_env_info(MDBX_env *env, MDBX_envinfo *info, size_t bytes);
+
+/* Flush the environment data buffers to disk.
+ *
+ * Unless the environment was opened with no-sync flags (MDBX_NOMETASYNC,
+ * MDBX_NOSYNC, MDBX_UTTERLY_NOSYNC and MDBX_MAPASYNC), then data is always
+ * written an flushed to disk when mdbx_txn_commit() is called. Otherwise
+ * mdbx_env_sync() may be called to manually write and flush unsynced data to
+ * disk.
+ *
+ * Besides, mdbx_env_sync_ex() with argument force=false may be used to
+ * provide polling mode for lazy/asynchronous sync in conjunction with
+ * mdbx_env_set_syncbytes() and/or mdbx_env_set_syncperiod().
+ *
+ * The mdbx_env_sync() is shortcut to calling mdbx_env_sync_ex() with
+ * try force=true and nonblock=false arguments.
+ *
+ * The mdbx_env_sync_poll() is shortcut to calling mdbx_env_sync_ex() with
+ * the force=false and nonblock=true arguments.
+ *
+ * NOTE: This call is not valid if the environment was opened with MDBX_RDONLY.
+ *
+ * [in] env An environment handle returned by mdbx_env_create().
+ * [in] force If non-zero, force a flush. Otherwise, if force is zero, then
+ * will run in polling mode, i.e. it will check the thresholds
+ * that were set mdbx_env_set_syncbytes() and/or
+ * mdbx_env_set_syncperiod() and perform flush If at least one
+ * of the thresholds is reached.
+ * [in] nonblock Don't wait if write transaction is running by other thread.
+ *
+ * Returns A non-zero error value on failure and MDBX_RESULT_TRUE or 0 on
+ * success. The MDBX_RESULT_TRUE means no data pending for flush to disk,
+ * and 0 otherwise. Some possible errors are:
+ * - MDBX_EACCES = the environment is read-only.
+ * - MDBX_BUSY = the environment is used by other thread and nonblock=true.
+ * - MDBX_EINVAL = an invalid parameter was specified.
+ * - MDBX_EIO = an error occurred during synchronization. */
+LIBMDBX_API int mdbx_env_sync_ex(MDBX_env *env, int force, int nonblock);
+LIBMDBX_API int mdbx_env_sync(MDBX_env *env);
+LIBMDBX_API int mdbx_env_sync_poll(MDBX_env *env);
+
+/* Sets threshold to force flush the data buffers to disk, even of MDBX_NOSYNC,
+ * MDBX_NOMETASYNC and MDBX_MAPASYNC flags in the environment. The threshold
+ * value affects all processes which operates with given environment until the
+ * last process close environment or a new value will be settled.
+ *
+ * Data is always written to disk when mdbx_txn_commit() is called, but the
+ * operating system may keep it buffered. MDBX always flushes the OS buffers
+ * upon commit as well, unless the environment was opened with MDBX_NOSYNC,
+ * MDBX_MAPASYNC or in part MDBX_NOMETASYNC.
+ *
+ * The default is 0, than mean no any threshold checked, and no additional
+ * flush will be made.
+ *
+ * [in] env An environment handle returned by mdbx_env_create().
+ * [in] threshold The size in bytes of summary changes when a synchronous
+ * flush would be made.
+ *
+ * Returns A non-zero error value on failure and 0 on success. */
+LIBMDBX_API int mdbx_env_set_syncbytes(MDBX_env *env, size_t threshold);
+
+/* Sets relative period since the last unsteay commit to force flush the data
+ * buffers to disk, even of MDBX_NOSYNC, MDBX_NOMETASYNC and MDBX_MAPASYNC flags
+ * in the environment. The relative period value affects all processes which
+ * operates with given environment until the last process close environment or a
+ * new value will be settled.
+ *
+ * Data is always written to disk when mdbx_txn_commit() is called, but the
+ * operating system may keep it buffered. MDBX always flushes the OS buffers
+ * upon commit as well, unless the environment was opened with MDBX_NOSYNC,
+ * MDBX_MAPASYNC or in part MDBX_NOMETASYNC.
+ *
+ * Settled period don't checked asynchronously, but only by the
+ * mdbx_txn_commit() and mdbx_env_sync() functions. Therefore, in cases where
+ * transactions are committed infrequently and/or irregularly, polling by
+ * mdbx_env_sync() may be a reasonable solution to timeout enforcement.
+ *
+ * The default is 0, than mean no any timeout checked, and no additional
+ * flush will be made.
+ *
+ * [in] env An environment handle returned by mdbx_env_create().
+ * [in] seconds_16dot16 The period in 1/65536 of second when a synchronous
+ * flush would be made since the last unsteay commit.
+ *
+ * Returns A non-zero error value on failure and 0 on success. */
+LIBMDBX_API int mdbx_env_set_syncperiod(MDBX_env *env,
+ unsigned seconds_16dot16);
+
+/* Close the environment and release the memory map.
+ *
+ * Only a single thread may call this function. All transactions, databases,
+ * and cursors must already be closed before calling this function. Attempts
+ * to use any such handles after calling this function will cause a SIGSEGV.
+ * The environment handle will be freed and must not be used again after this
+ * call.
+ *
+ * Legacy mdbx_env_close() correspond to calling mdbx_env_close_ex() with the
+ * argument dont_sync=false.
+ *
+ * [in] env An environment handle returned by mdbx_env_create().
+ * [in] dont_sync A dont'sync flag, if non-zero the last checkpoint (meta-page
+ * update) will be kept "as is" and may be still "weak" in the
+ * NOSYNC/MAPASYNC modes. Such "weak" checkpoint will be
+ * ignored on opening next time, and transactions since the
+ * last non-weak checkpoint (meta-page update) will rolledback
+ * for consistency guarantee.
+ *
+ * Returns A non-zero error value on failure and 0 on success.
+ * Some possible errors are:
+ * - MDBX_BUSY = The write transaction is running by other thread, in such
+ * case MDBX_env instance has NOT be destroyed not released!
+ * NOTE: if any OTHER error code was returned then given
+ * MDBX_env instance has been destroyed and released.
+ * - MDBX_PANIC = If mdbx_env_close_ex() was called in the child process
+ * after fork(). In this case MDBX_PANIC is a expecte,
+ * i.e. MDBX_env instance was freed in proper manner.
+ * - MDBX_EIO = an error occurred during synchronization. */
+LIBMDBX_API int mdbx_env_close_ex(MDBX_env *env, int dont_sync);
+LIBMDBX_API int mdbx_env_close(MDBX_env *env);
+
+/* Set environment flags.
+ *
+ * This may be used to set some flags in addition to those from
+ * mdbx_env_open(), or to unset these flags.
+ *
+ * NOTE: In contrast to LMDB, the MDBX serialize threads via mutex while
+ * changing the flags. Therefore this function will be blocked while a write
+ * transaction running by other thread, or MDBX_BUSY will be returned if
+ * function called within a write transaction.
+ *
+ * [in] env An environment handle returned by mdbx_env_create().
+ * [in] flags The flags to change, bitwise OR'ed together.
+ * [in] onoff A non-zero value sets the flags, zero clears them.
+ *
+ * Returns A non-zero error value on failure and 0 on success, some
+ * possible errors are:
+ * - MDBX_EINVAL = an invalid parameter was specified. */
+LIBMDBX_API int mdbx_env_set_flags(MDBX_env *env, unsigned flags, int onoff);
+
+/* Get environment flags.
+ *
+ * [in] env An environment handle returned by mdbx_env_create().
+ * [out] flags The address of an integer to store the flags.
+ *
+ * Returns A non-zero error value on failure and 0 on success, some
+ * possible errors are:
+ * - MDBX_EINVAL = an invalid parameter was specified. */
+LIBMDBX_API int mdbx_env_get_flags(MDBX_env *env, unsigned *flags);
+
+/* Return the path that was used in mdbx_env_open().
+ *
+ * [in] env An environment handle returned by mdbx_env_create()
+ * [out] dest Address of a string pointer to contain the path.
+ * This is the actual string in the environment, not a copy.
+ * It should not be altered in any way.
+ *
+ * Returns A non-zero error value on failure and 0 on success, some
+ * possible errors are:
+ * - MDBX_EINVAL = an invalid parameter was specified. */
+LIBMDBX_API int mdbx_env_get_path(MDBX_env *env, const char **dest);
+
+/* Return the file descriptor for the given environment.
+ *
+ * NOTE: All MDBX file descriptors have FD_CLOEXEC and
+ * could't be used after exec() and or fork().
+ *
+ * [in] env An environment handle returned by mdbx_env_create().
+ * [out] fd Address of a int to contain the descriptor.
+ *
+ * Returns A non-zero error value on failure and 0 on success, some
+ * possible errors are:
+ * - MDBX_EINVAL = an invalid parameter was specified. */
+LIBMDBX_API int mdbx_env_get_fd(MDBX_env *env, mdbx_filehandle_t *fd);
+
+/* Set all size-related parameters of environment, including page size and the
+ * min/max size of the memory map.
+ *
+ * In contrast to LMDB, the MDBX provide automatic size management of an
+ * database according the given parameters, including shrinking and resizing
+ * on the fly. From user point of view all of these just working. Nevertheless,
+ * it is reasonable to know some details in order to make optimal decisions when
+ * choosing parameters.
+ *
+ * Both mdbx_env_info_ex() and legacy mdbx_env_info() are inapplicable to
+ * read-only opened environment.
+ *
+ * Both mdbx_env_info_ex() and legacy mdbx_env_info() could be called either
+ * before or after mdbx_env_open(), either within the write transaction running
+ * by current thread or not:
+ *
+ * - In case mdbx_env_info_ex() or legacy mdbx_env_info() was called BEFORE
+ * mdbx_env_open(), i.e. for closed environment, then the specified
+ * parameters will be used for new database creation, or will be appliend
+ * during openeing if database exists and no other process using it.
+ *
+ * If the database is already exist, opened with MDBX_EXCLUSIVE or not used
+ * by any other process, and parameters specified by mdbx_env_set_geometry()
+ * are incompatible (i.e. for instance, different page size) then
+ * mdbx_env_open() will return MDBX_INCOMPATIBLE error.
+ *
+ * In another way, if database will opened read-only or will used by other
+ * process during calling mdbx_env_open() that specified parameters will
+ * silently discarded (open the database with MDBX_EXCLUSIVE flag to avoid
+ * this).
+ *
+ * - In case mdbx_env_info_ex() or legacy mdbx_env_info() was called after
+ * mdbx_env_open() WITHIN the write transaction running by current thread,
+ * then specified parameters will be appliad as a part of write transaction,
+ * i.e. will not be visible to any others processes until the current write
+ * transaction has been committed by the current process. However, if
+ * transaction will be aborted, then the database file will be reverted to
+ * the previous size not immediately, but when a next transaction will be
+ * committed or when the database will be opened next time.
+ *
+ * - In case mdbx_env_info_ex() or legacy mdbx_env_info() was called after
+ * mdbx_env_open() but OUTSIDE a write transaction, then MDBX will execute
+ * internal pseudo-transaction to apply new parameters (but only if anything
+ * has been changed), and changes be visible to any others processes
+ * immediatelly after succesfull competeion of function.
+ *
+ * Essentially a concept of "automatic size management" is simple and useful:
+ * - There are the lower and upper bound of the database file size;
+ * - There is the growth step by which the database file will be increased,
+ * in case of lack of space.
+ * - There is the threshold for unused space, beyond which the database file
+ * will be shrunk.
+ * - The size of the memory map is also the maximum size of the database.
+ * - MDBX will automatically manage both the size of the database and the size
+ * of memory map, according to the given parameters.
+ *
+ * So, there some considerations about choosing these parameters:
+ * - The lower bound allows you to prevent database shrinking below some
+ * rational size to avoid unnecessary resizing costs.
+ * - The upper bound allows you to prevent database growth above some rational
+ * size. Besides, the upper bound defines the linear address space
+ * reservation in each process that opens the database. Therefore changing
+ * the upper bound is costly and may be required reopening environment in
+ * case of MDBX_MAP_RESIZED errors, and so on. Therefore, this value should
+ * be chosen reasonable as large as possible, to accommodate future growth
+ * of the database.
+ * - The growth step must be greater than zero to allow the database to grow,
+ * but also reasonable not too small, since increasing the size by little
+ * steps will result a large overhead.
+ * - The shrink threshold must be greater than zero to allow the database
+ * to shrink but also reasonable not too small (to avoid extra overhead) and
+ * not less than growth step to avoid up-and-down flouncing.
+ * - The current size (i.e. size_now argument) is an auxiliary parameter for
+ * simulation legacy mdbx_env_set_mapsize() and as workaround Windows issues
+ * (see below).
+ *
+ * Unfortunately, Windows has is a several issues
+ * with resizing of memory-mapped file:
+ * - Windows unable shrinking a memory-mapped file (i.e memory-mapped section)
+ * in any way except unmapping file entirely and then map again. Moreover,
+ * it is impossible in any way if a memory-mapped file is used more than
+ * one process.
+ * - Windows does not provide the usual API to augment a memory-mapped file
+ * (that is, a memory-mapped partition), but only by using "Native API"
+ * in an undocumented way.
+ * MDBX bypasses all Windows issues, but at a cost:
+ * - Ability to resize database on the fly requires an additional lock
+ * and release SlimReadWriteLock during each read-only transaction.
+ * - During resize all in-process threads should be paused and then resumed.
+ * - Shrinking of database file is performed only when it used by single
+ * process, i.e. when a database closes by the last process or opened
+ * by the first.
+ * = Therefore, the size_now argument may be useful to set database size
+ * by the first process which open a database, and thus avoid expensive
+ * remapping further.
+ *
+ * For create a new database with particular parameters, including the page
+ * size, mdbx_env_set_geometry() should be called after mdbx_env_create() and
+ * before mdbx_env_open(). Once the database is created, the page size cannot be
+ * changed. If you do not specify all or some of the parameters, the
+ * corresponding default values will be used. For instance, the default for
+ * database size is 10485760 bytes.
+ *
+ * If the mapsize is increased by another process, MDBX silently and
+ * transparently adopt these changes at next transaction start. However,
+ * mdbx_txn_begin() will return MDBX_MAP_RESIZED if new mapping size could not
+ * be applied for current process (for instance if address space is busy).
+ * Therefore, in the case of MDBX_MAP_RESIZED error you need close and reopen
+ * the environment to resolve error.
+ *
+ * NOTE: Actual values may be different than your have specified because of
+ * rounding to specified database page size, the system page size and/or the
+ * size of the system virtual memory management unit. You can get actual values
+ * by mdbx_env_sync_ex() or see by using the tool "mdbx_chk" with the "-v"
+ * option.
+ *
+ * Legacy mdbx_env_set_mapsize() correspond to calling mdbx_env_set_geometry()
+ * with the arguments size_lower, size_now, size_upper equal to the size
+ * and -1 (i.e. default) for all other parameters.
+ *
+ * [in] env An environment handle returned by mdbx_env_create()
+ *
+ * [in] size_lower The lower bound of database sive in bytes.
+ * Zero value means "minimal acceptable",
+ * and negative means "keep current or use default".
+ *
+ * [in] size_now The size in bytes to setup the database size for now.
+ * Zero value means "minimal acceptable",
+ * and negative means "keep current or use default".
+ * So, it is recommended always pass -1 in this argument
+ * except some special cases.
+ *
+ * [in] size_upper The upper bound of database sive in bytes.
+ * Zero value means "minimal acceptable",
+ * and negative means "keep current or use default".
+ * It is recommended to avoid change upper bound while
+ * database is used by other processes or threaded
+ * (i.e. just pass -1 in this argument except absolutely
+ * necessity). Otherwise you must be ready for
+ * MDBX_MAP_RESIZED error(s), unexpected pauses during
+ * remapping and/or system errors like "addtress busy",
+ * and so on. In other words, there is no way to handle
+ * a growth of the upper bound robustly because there may
+ * be a lack of appropriate system resources (which are
+ * extremely volatile in a multi-process multi-threaded
+ * environment).
+ *
+ * [in] growth_step The growth step in bytes, must be greater than zero
+ * to allow the database to grow.
+ * Negative value means "keep current or use default".
+ *
+ * [in] shrink_threshold The shrink threshold in bytes, must be greater than
+ * zero to allow the database to shrink.
+ * Negative value means "keep current or use default".
+ *
+ * [in] pagesize The database page size for new database creation
+ * or -1 otherwise. Must be power of 2 in the range
+ * between MDBX_MIN_PAGESIZE and MDBX_MAX_PAGESIZE.
+ * Zero value means "minimal acceptable",
+ * and negative means "keep current or use default".
+ *
+ * Returns A non-zero error value on failure and 0 on success,
+ * some possible errors are:
+ * - MDBX_EINVAL = An invalid parameter was specified,
+ * or the environment has an active write transaction.
+ * - MDBX_EPERM = specific for Windows: Shrinking was disabled before and
+ * now it wanna be enabled, but there are reading threads
+ * that don't use the additional SRWL (that is required to
+ * avoid Windows issues).
+ * - MDBX_EACCESS = The environment opened in read-only.
+ * - MDBX_MAP_FULL = Specified size smaller than the space already
+ * consumed by the environment.
+ * - MDBX_TOO_LARGE = Specified size is too large, i.e. too many pages for
+ * given size, or a 32-bit process requests too much bytes
+ * for the 32-bit address space. */
+LIBMDBX_API int mdbx_env_set_geometry(MDBX_env *env, intptr_t size_lower,
+ intptr_t size_now, intptr_t size_upper,
+ intptr_t growth_step,
+ intptr_t shrink_threshold,
+ intptr_t pagesize);
+LIBMDBX_API int mdbx_env_set_mapsize(MDBX_env *env, size_t size);
+
+/* Find out whether to use readahead or not, based on the given database size
+ * and the amount of available memory.
+ *
+ * [in] volume The expected database size in bytes.
+ * [in] redundancy Additional reserve or overload in case of negative value.
+ *
+ * Returns:
+ * - MDBX_RESULT_TRUE = readahead is reasonable.
+ * - MDBX_RESULT_FALSE = readahead is NOT reasonable, i.e. MDBX_NORDAHEAD
+ * is useful to open environment by mdbx_env_open().
+ * - Otherwise the error code. */
+LIBMDBX_API int mdbx_is_readahead_reasonable(size_t volume,
+ intptr_t redundancy);
+
+/* The minimal database page size in bytes. */
+#define MDBX_MIN_PAGESIZE 256
+__inline intptr_t mdbx_limits_pgsize_min(void) { return MDBX_MIN_PAGESIZE; }
+
+/* The maximal database page size in bytes. */
+#define MDBX_MAX_PAGESIZE 65536
+__inline intptr_t mdbx_limits_pgsize_max(void) { return MDBX_MAX_PAGESIZE; }
+
+/* Returns minimal database size in bytes for given page size,
+ * or the negative error code. */
+LIBMDBX_API intptr_t mdbx_limits_dbsize_min(intptr_t pagesize);
+
+/* Returns maximal database size in bytes for given page size,
+ * or the negative error code. */
+LIBMDBX_API intptr_t mdbx_limits_dbsize_max(intptr_t pagesize);
+
+/* Returns maximal key size in bytes for given page size,
+ * or the negative error code. */
+LIBMDBX_API intptr_t mdbx_limits_keysize_max(intptr_t pagesize);
+
+/* Returns maximal write transaction size (i.e. limit for summary volume of
+ * dirty pages) in bytes for given page size, or the negative error code. */
+LIBMDBX_API intptr_t mdbx_limits_txnsize_max(intptr_t pagesize);
+
+/* Set the maximum number of threads/reader slots for the environment.
+ *
+ * This defines the number of slots in the lock table that is used to track
+ * readers in the the environment. The default is 119 for 4K system page size.
+ * Starting a read-only transaction normally ties a lock table slot to the
+ * current thread until the environment closes or the thread exits. If
+ * MDBX_NOTLS is in use, mdbx_txn_begin() instead ties the slot to the
+ * MDBX_txn object until it or the MDBX_env object is destroyed.
+ * This function may only be called after mdbx_env_create() and before
+ * mdbx_env_open().
+ *
+ * [in] env An environment handle returned by mdbx_env_create().
+ * [in] readers The maximum number of reader lock table slots.
+ *
+ * Returns A non-zero error value on failure and 0 on success, some
+ * possible errors are:
+ * - MDBX_EINVAL = an invalid parameter was specified.
+ * - MDBX_EPERM = the environment is already open. */
+LIBMDBX_API int mdbx_env_set_maxreaders(MDBX_env *env, unsigned readers);
+
+/* Get the maximum number of threads/reader slots for the environment.
+ *
+ * [in] env An environment handle returned by mdbx_env_create().
+ * [out] readers Address of an integer to store the number of readers.
+ *
+ * Returns A non-zero error value on failure and 0 on success, some
+ * possible errors are:
+ * - MDBX_EINVAL = an invalid parameter was specified. */
+LIBMDBX_API int mdbx_env_get_maxreaders(MDBX_env *env, unsigned *readers);
+
+/* Set the maximum number of named databases for the environment.
+ *
+ * This function is only needed if multiple databases will be used in the
+ * environment. Simpler applications that use the environment as a single
+ * unnamed database can ignore this option.
+ * This function may only be called after mdbx_env_create() and before
+ * mdbx_env_open().
+ *
+ * Currently a moderate number of slots are cheap but a huge number gets
+ * expensive: 7-120 words per transaction, and every mdbx_dbi_open()
+ * does a linear search of the opened slots.
+ *
+ * [in] env An environment handle returned by mdbx_env_create().
+ * [in] dbs The maximum number of databases.
+ *
+ * Returns A non-zero error value on failure and 0 on success, some
+ * possible errors are:
+ * - MDBX_EINVAL = an invalid parameter was specified.
+ * - MDBX_EPERM = the environment is already open. */
+LIBMDBX_API int mdbx_env_set_maxdbs(MDBX_env *env, MDBX_dbi dbs);
+
+/* Get the maximum size of keys and MDBX_DUPSORT data we can write.
+ *
+ * [in] env An environment handle returned by mdbx_env_create().
+ *
+ * Returns The maximum size of a key we can write. */
+LIBMDBX_API int mdbx_env_get_maxkeysize(MDBX_env *env);
+
+/* Set application information associated with the MDBX_env.
+ *
+ * [in] env An environment handle returned by mdbx_env_create().
+ * [in] ctx An arbitrary pointer for whatever the application needs.
+ *
+ * Returns A non-zero error value on failure and 0 on success. */
+LIBMDBX_API int mdbx_env_set_userctx(MDBX_env *env, void *ctx);
+
+/* Get the application information associated with the MDBX_env.
+ *
+ * [in] env An environment handle returned by mdbx_env_create()
+ * Returns The pointer set by mdbx_env_set_userctx(). */
+LIBMDBX_API void *mdbx_env_get_userctx(MDBX_env *env);
+
+/* Create a transaction for use with the environment.
+ *
+ * The transaction handle may be discarded using mdbx_txn_abort()
+ * or mdbx_txn_commit().
+ *
+ * NOTE: A transaction and its cursors must only be used by a single thread,
+ * and a thread may only have a single transaction at a time. If MDBX_NOTLS is
+ * in use, this does not apply to read-only transactions.
+ *
+ * NOTE: Cursors may not span transactions.
+ *
+ * [in] env An environment handle returned by mdbx_env_create()
+ * [in] parent If this parameter is non-NULL, the new transaction will be
+ * a nested transaction, with the transaction indicated by parent
+ * as its parent. Transactions may be nested to any level.
+ * A parent transaction and its cursors may not issue any other
+ * operations than mdbx_txn_commit and mdbx_txn_abort while it
+ * has active child transactions.
+ * [in] flags Special options for this transaction. This parameter
+ * must be set to 0 or by bitwise OR'ing together one or more
+ * of the values described here.
+ *
+ * - MDBX_RDONLY
+ * This transaction will not perform any write operations.
+ *
+ * - MDBX_TRYTXN
+ * Do not block when starting a write transaction.
+ *
+ * - MDBX_NOSYNC, MDBX_NOMETASYNC or MDBX_MAPASYNC
+ * Do not sync data to disk corresponding to MDBX_NOMETASYNC
+ * or MDBX_NOSYNC description (see abobe).
+ *
+ * [out] txn Address where the new MDBX_txn handle will be stored
+ *
+ * Returns A non-zero error value on failure and 0 on success, some
+ * possible errors are:
+ * - MDBX_PANIC = a fatal error occurred earlier and the environment
+ * must be shut down.
+ * - MDBX_MAP_RESIZED = another process wrote data beyond this MDBX_env's
+ * mapsize and this environment's map must be resized
+ * as well. See mdbx_env_set_mapsize().
+ * - MDBX_READERS_FULL = a read-only transaction was requested and the reader
+ * lock table is full. See mdbx_env_set_maxreaders().
+ * - MDBX_ENOMEM = out of memory.
+ * - MDBX_BUSY = the write transaction is already started by the
+ * current thread. */
+LIBMDBX_API int mdbx_txn_begin(MDBX_env *env, MDBX_txn *parent, unsigned flags,
+ MDBX_txn **txn);
+
+/* Information about the transaction */
+typedef struct MDBX_txn_info {
+ uint64_t txn_id; /* The ID of the transaction. For a READ-ONLY transaction,
+ this corresponds to the snapshot being read. */
+
+ uint64_t
+ txn_reader_lag; /* For READ-ONLY transaction: the lag from a recent
+ MVCC-snapshot, i.e. the number of committed
+ transaction since read transaction started.
+ For WRITE transaction (provided if scan_rlt=true): the
+ lag of the oldest reader from current transaction (i.e.
+ atleast 1 if any reader running). */
+
+ uint64_t txn_space_used; /* Used space by this transaction, i.e. corresponding
+ to the last used database page. */
+
+ uint64_t txn_space_limit_soft; /* Current size of database file. */
+
+ uint64_t
+ txn_space_limit_hard; /* Upper bound for size the database file,
+ i.e. the value "size_upper" argument of the
+ approriate call of mdbx_env_set_geometry(). */
+
+ uint64_t txn_space_retired; /* For READ-ONLY transaction: The total size of
+ the database pages that were retired by
+ committed write transactions after the reader's
+ MVCC-snapshot, i.e. the space which would be
+ freed after the Reader releases the
+ MVCC-snapshot for reuse by completion read
+ transaction.
+ For WRITE transaction: The summarized size of
+ the database pages that were retired for now
+ due Copy-On-Write during this transaction. */
+
+ uint64_t
+ txn_space_leftover; /* For READ-ONLY transaction: the space available for
+ writer(s) and that must be exhausted for reason to
+ call the OOM-killer for this read transaction.
+ For WRITE transaction: the space inside transaction
+ that left to MDBX_TXN_FULL error. */
+
+ uint64_t txn_space_dirty; /* For READ-ONLY transaction (provided if
+ scan_rlt=true): The space that actually become
+ available for reuse when only this transaction
+ will be finished.
+ For WRITE transaction: The summarized size of the
+ dirty database pages that generated during this
+ transaction. */
+} MDBX_txn_info;
+
+/* Return information about the MDBX transaction.
+ *
+ * [in] txn A transaction handle returned by mdbx_txn_begin().
+ * [out] stat The address of an MDBX_txn_info structure
+ * where the information will be copied.
+ * [in[ scan_rlt The boolean flag controls the scan of the read lock table to
+ * provide complete information. Such scan is relatively
+ * expensive and you can avoid it if corresponding fields are
+ * not needed (see description of MDBX_txn_info above).
+ *
+ * Returns A non-zero error value on failure and 0 on success. */
+LIBMDBX_API int mdbx_txn_info(MDBX_txn *txn, MDBX_txn_info *info, int scan_rlt);
+
+/* Returns the transaction's MDBX_env.
+ *
+ * [in] txn A transaction handle returned by mdbx_txn_begin() */
+LIBMDBX_API MDBX_env *mdbx_txn_env(MDBX_txn *txn);
+
+/* Return the transaction's flags.
+ *
+ * This returns the flags associated with this transaction.
+ *
+ * [in] txn A transaction handle returned by mdbx_txn_begin().
+ *
+ * Returns A transaction flags, valid if input is an valid transaction,
+ * otherwise -1. */
+LIBMDBX_API int mdbx_txn_flags(MDBX_txn *txn);
+
+/* Return the transaction's ID.
+ *
+ * This returns the identifier associated with this transaction. For a read-only
+ * transaction, this corresponds to the snapshot being read; concurrent readers
+ * will frequently have the same transaction ID.
+ *
+ * [in] txn A transaction handle returned by mdbx_txn_begin().
+ *
+ * Returns A transaction ID, valid if input is an active transaction,
+ * otherwise 0. */
+LIBMDBX_API uint64_t mdbx_txn_id(MDBX_txn *txn);
+
+/* Commit all the operations of a transaction into the database.
+ *
+ * The transaction handle is freed. It and its cursors must not be used again
+ * after this call, except with mdbx_cursor_renew() and mdbx_cursor_close().
+ *
+ * A cursor must be closed explicitly always, before or after its transaction
+ * ends. It can be reused with mdbx_cursor_renew() before finally closing it.
+ *
+ * [in] txn A transaction handle returned by mdbx_txn_begin().
+ *
+ * Returns A non-zero error value on failure and 0 on success, some
+ * possible errors are:
+ * - MDBX_EINVAL = an invalid parameter was specified.
+ * - MDBX_ENOSPC = no more disk space.
+ * - MDBX_EIO = a low-level I/O error occurred while writing.
+ * - MDBX_ENOMEM = out of memory. */
+LIBMDBX_API int mdbx_txn_commit(MDBX_txn *txn);
+
+/* Abandon all the operations of the transaction instead of saving them.
+ *
+ * The transaction handle is freed. It and its cursors must not be used again
+ * after this call, except with mdbx_cursor_renew() and mdbx_cursor_close().
+ *
+ * A cursor must be closed explicitly always, before or after its transaction
+ * ends. It can be reused with mdbx_cursor_renew() before finally closing it.
+ *
+ * [in] txn A transaction handle returned by mdbx_txn_begin().
+ *
+ * Returns A non-zero error value on failure and 0 on success. */
+LIBMDBX_API int mdbx_txn_abort(MDBX_txn *txn);
+
+/* Reset a read-only transaction.
+ *
+ * Abort the read-only transaction like mdbx_txn_abort(), but keep the
+ * transaction handle. Therefore mdbx_txn_renew() may reuse the handle. This
+ * saves allocation overhead if the process will start a new read-only
+ * transaction soon, and also locking overhead if MDBX_NOTLS is in use. The
+ * reader table lock is released, but the table slot stays tied to its thread or
+ * MDBX_txn. Use mdbx_txn_abort() to discard a reset handle, and to free its
+ * lock table slot if MDBX_NOTLS is in use.
+ *
+ * Cursors opened within the transaction must not be used again after this call,
+ * except with mdbx_cursor_renew() and mdbx_cursor_close().
+ *
+ * Reader locks generally don't interfere with writers, but they keep old
+ * versions of database pages allocated. Thus they prevent the old pages from
+ * being reused when writers commit new data, and so under heavy load the
+ * database size may grow much more rapidly than otherwise.
+ *
+ * [in] txn A transaction handle returned by mdbx_txn_begin().
+ *
+ * Returns A non-zero error value on failure and 0 on success. */
+LIBMDBX_API int mdbx_txn_reset(MDBX_txn *txn);
+
+/* Renew a read-only transaction.
+ *
+ * This acquires a new reader lock for a transaction handle that had been
+ * released by mdbx_txn_reset(). It must be called before a reset transaction
+ * may be used again.
+ *
+ * [in] txn A transaction handle returned by mdbx_txn_begin().
+ *
+ * Returns A non-zero error value on failure and 0 on success, some
+ * possible errors are:
+ * - MDBX_PANIC = a fatal error occurred earlier and the environment
+ * must be shut down.
+ * - MDBX_EINVAL = an invalid parameter was specified. */
+LIBMDBX_API int mdbx_txn_renew(MDBX_txn *txn);
+
+/* The fours integers markers (aka "canary") associated with the environment.
+ *
+ * The `x`, `y` and `z` values could be set by mdbx_canary_put(), while the 'v'
+ * will be always set to the transaction number. Updated values becomes visible
+ * outside the current transaction only after it was committed. Current values
+ * could be retrieved by mdbx_canary_get(). */
+typedef struct mdbx_canary {
+ uint64_t x, y, z, v;
+} mdbx_canary;
+
+/* Set integers markers (aka "canary") associated with the environment.
+ *
+ * [in] txn A transaction handle returned by mdbx_txn_begin()
+ * [in] canary A optional pointer to mdbx_canary structure for `x`, `y`
+ * and `z` values from.
+ * - If canary is NOT NULL then the `x`, `y` and `z` values will be
+ * updated from given canary argument, but the 'v' be always set
+ * to the current transaction number if at least one `x`, `y` or
+ * `z` values have changed (i.e. if `x`, `y` and `z` have the same
+ * values as currently present then nothing will be changes or
+ * updated).
+ * - if canary is NULL then the `v` value will be explicitly update
+ * to the current transaction number without changes `x`, `y` nor
+ * `z`.
+ *
+ * Returns A non-zero error value on failure and 0 on success. */
+LIBMDBX_API int mdbx_canary_put(MDBX_txn *txn, const mdbx_canary *canary);
+
+/* Returns fours integers markers (aka "canary") associated with the
+ * environment.
+ *
+ * [in] txn A transaction handle returned by mdbx_txn_begin().
+ * [in] canary The address of an mdbx_canary structure where the information
+ * will be copied.
+ *
+ * Returns A non-zero error value on failure and 0 on success. */
+LIBMDBX_API int mdbx_canary_get(MDBX_txn *txn, mdbx_canary *canary);
+
+/* A callback function used to compare two keys in a database */
+typedef int(MDBX_cmp_func)(const MDBX_val *a, const MDBX_val *b);
+
+/* Open a database in the environment.
+ *
+ * A database handle denotes the name and parameters of a database,
+ * independently of whether such a database exists. The database handle may be
+ * discarded by calling mdbx_dbi_close(). The old database handle is returned if
+ * the database was already open. The handle may only be closed once.
+ *
+ * (!) A notable difference between MDBX and LMDB is that MDBX make handles
+ * opened for existing databases immediately available for other transactions,
+ * regardless this transaction will be aborted or reset. The REASON for this is
+ * to avoiding the requirement for multiple opening a same handles in concurrent
+ * read transactions, and tracking of such open but hidden handles until the
+ * completion of read transactions which opened them.
+ *
+ * Nevertheless, the handle for the NEWLY CREATED database will be invisible for
+ * other transactions until the this write transaction is successfully
+ * committed. If the write transaction is aborted the handle will be closed
+ * automatically. After a successful commit the such handle will reside in the
+ * shared environment, and may be used by other transactions.
+ *
+ * In contrast to LMDB, the MDBX allow this function to be called from multiple
+ * concurrent transactions or threads in the same process.
+ *
+ * Legacy mdbx_dbi_open() correspond to calling mdbx_dbi_open_ex() with the null
+ * keycmp and datacmp arguments.
+ *
+ * To use named database (with name != NULL), mdbx_env_set_maxdbs()
+ * must be called before opening the environment. Table names are
+ * keys in the internal unnamed database, and may be read but not written.
+ *
+ * [in] txn transaction handle returned by mdbx_txn_begin().
+ * [in] name The name of the database to open. If only a single
+ * database is needed in the environment, this value may be NULL.
+ * [in] flags Special options for this database. This parameter must be set
+ * to 0 or by bitwise OR'ing together one or more of the values
+ * described here:
+ * - MDBX_REVERSEKEY
+ * Keys are strings to be compared in reverse order, from the end
+ * of the strings to the beginning. By default, Keys are treated as
+ * strings and compared from beginning to end.
+ * - MDBX_DUPSORT
+ * Duplicate keys may be used in the database. Or, from another point of
+ * view, keys may have multiple data items, stored in sorted order. By
+ * default keys must be unique and may have only a single data item.
+ * - MDBX_INTEGERKEY
+ * Keys are binary integers in native byte order, either uin32_t or
+ * uint64_t, and will be sorted as such. The keys must all be of the
+ * same size.
+ * - MDBX_DUPFIXED
+ * This flag may only be used in combination with MDBX_DUPSORT. This
+ * option tells the library that the data items for this database are
+ * all the same size, which allows further optimizations in storage and
+ * retrieval. When all data items are the same size, the MDBX_GET_MULTIPLE,
+ * MDBX_NEXT_MULTIPLE and MDBX_PREV_MULTIPLE cursor operations may be used
+ * to retrieve multiple items at once.
+ * - MDBX_INTEGERDUP
+ * This option specifies that duplicate data items are binary integers,
+ * similar to MDBX_INTEGERKEY keys.
+ * - MDBX_REVERSEDUP
+ * This option specifies that duplicate data items should be compared as
+ * strings in reverse order (the comparison is performed in the direction
+ * from the last byte to the first).
+ * - MDBX_CREATE
+ * Create the named database if it doesn't exist. This option is not
+ * allowed in a read-only transaction or a read-only environment.
+ *
+ * [in] keycmp Optional custom key comparison function for a database.
+ * [in] datacmp Optional custom data comparison function for a database, takes
+ * effect only if database was opened with the MDB_DUPSORT flag.
+ * [out] dbi Address where the new MDBX_dbi handle will be stored.
+ *
+ * Returns A non-zero error value on failure and 0 on success, some
+ * possible errors are:
+ * - MDBX_NOTFOUND = the specified database doesn't exist in the
+ * environment and MDBX_CREATE was not specified.
+ * - MDBX_DBS_FULL = too many databases have been opened.
+ * See mdbx_env_set_maxdbs().
+ * - MDBX_INCOMPATIBLE = Database is incompatible with given flags,
+ * i.e. the passed flags is different with which the
+ * database was created, or the database was already
+ * opened with a different comparison function(s). */
+LIBMDBX_API int mdbx_dbi_open_ex(MDBX_txn *txn, const char *name,
+ unsigned flags, MDBX_dbi *dbi,
+ MDBX_cmp_func *keycmp, MDBX_cmp_func *datacmp);
+LIBMDBX_API int mdbx_dbi_open(MDBX_txn *txn, const char *name, unsigned flags,
+ MDBX_dbi *dbi);
+
+/* Retrieve statistics for a database.
+ *
+ * [in] txn A transaction handle returned by mdbx_txn_begin().
+ * [in] dbi A database handle returned by mdbx_dbi_open().
+ * [out] stat The address of an MDBX_stat structure where the statistics
+ * will be copied.
+ *
+ * Returns A non-zero error value on failure and 0 on success, some
+ * possible errors are:
+ * - MDBX_EINVAL = an invalid parameter was specified. */
+LIBMDBX_API int mdbx_dbi_stat(MDBX_txn *txn, MDBX_dbi dbi, MDBX_stat *stat,
+ size_t bytes);
+
+/* Retrieve the DB flags and status for a database handle.
+ *
+ * [in] txn A transaction handle returned by mdbx_txn_begin().
+ * [in] dbi A database handle returned by mdbx_dbi_open().
+ * [out] flags Address where the flags will be returned.
+ * [out] state Address where the state will be returned.
+ *
+ * Legacy mdbx_dbi_flags() correspond to calling mdbx_dbi_flags_ex() with
+ * discarding result from the last argument.
+ *
+ * Returns A non-zero error value on failure and 0 on success. */
+#define MDBX_TBL_DIRTY 0x01 /* DB was written in this txn */
+#define MDBX_TBL_STALE 0x02 /* Named-DB record is older than txnID */
+#define MDBX_TBL_FRESH 0x04 /* Named-DB handle opened in this txn */
+#define MDBX_TBL_CREAT 0x08 /* Named-DB handle created in this txn */
+LIBMDBX_API int mdbx_dbi_flags_ex(MDBX_txn *txn, MDBX_dbi dbi, unsigned *flags,
+ unsigned *state);
+LIBMDBX_API int mdbx_dbi_flags(MDBX_txn *txn, MDBX_dbi dbi, unsigned *flags);
+
+/* Close a database handle. Normally unnecessary.
+ *
+ * NOTE: Use with care.
+ * This call is synchronized via mutex with mdbx_dbi_close(), but NOT with
+ * other transactions running by other threads. The "next" version of libmdbx
+ * (MithrilDB) will solve this issue.
+ *
+ * Handles should only be closed if no other threads are going to reference
+ * the database handle or one of its cursors any further. Do not close a handle
+ * if an existing transaction has modified its database. Doing so can cause
+ * misbehavior from database corruption to errors like MDBX_BAD_VALSIZE (since
+ * the DB name is gone).
+ *
+ * Closing a database handle is not necessary, but lets mdbx_dbi_open() reuse
+ * the handle value. Usually it's better to set a bigger mdbx_env_set_maxdbs(),
+ * unless that value would be large.
+ *
+ * [in] env An environment handle returned by mdbx_env_create().
+ * [in] dbi A database handle returned by mdbx_dbi_open().
+ *
+ * Returns A non-zero error value on failure and 0 on success. */
+LIBMDBX_API int mdbx_dbi_close(MDBX_env *env, MDBX_dbi dbi);
+
+/* Empty or delete and close a database.
+ *
+ * See mdbx_dbi_close() for restrictions about closing the DB handle.
+ *
+ * [in] txn A transaction handle returned by mdbx_txn_begin().
+ * [in] dbi A database handle returned by mdbx_dbi_open().
+ * [in] del 0 to empty the DB, 1 to delete it from the environment
+ * and close the DB handle.
+ *
+ * Returns A non-zero error value on failure and 0 on success. */
+LIBMDBX_API int mdbx_drop(MDBX_txn *txn, MDBX_dbi dbi, int del);
+
+/* Get items from a database.
+ *
+ * This function retrieves key/data pairs from the database. The address
+ * and length of the data associated with the specified key are returned
+ * in the structure to which data refers.
+ * If the database supports duplicate keys (MDBX_DUPSORT) then the
+ * first data item for the key will be returned. Retrieval of other
+ * items requires the use of mdbx_cursor_get().
+ *
+ * NOTE: The memory pointed to by the returned values is owned by the
+ * database. The caller need not dispose of the memory, and may not
+ * modify it in any way. For values returned in a read-only transaction
+ * any modification attempts will cause a SIGSEGV.
+ *
+ * NOTE: Values returned from the database are valid only until a
+ * subsequent update operation, or the end of the transaction.
+ *
+ * [in] txn A transaction handle returned by mdbx_txn_begin().
+ * [in] dbi A database handle returned by mdbx_dbi_open().
+ * [in] key The key to search for in the database.
+ * [in,out] data The data corresponding to the key.
+ *
+ * Returns A non-zero error value on failure and 0 on success, some
+ * possible errors are:
+ * - MDBX_NOTFOUND = the key was not in the database.
+ * - MDBX_EINVAL = an invalid parameter was specified. */
+LIBMDBX_API int mdbx_get(MDBX_txn *txn, MDBX_dbi dbi, MDBX_val *key,
+ MDBX_val *data);
+
+/* Get items from a database and optionaly number of data items for a given key.
+ *
+ * Briefly this function does the same as mdbx_get() with a few differences:
+ * 1. If values_count is NOT NULL, then returns the count
+ * of multi-values/duplicates for a given key.
+ * 2. Updates BOTH the key and the data for pointing to the actual key-value
+ * pair inside the database.
+ *
+ * [in] txn A transaction handle returned by mdbx_txn_begin().
+ * [in] dbi A database handle returned by mdbx_dbi_open().
+ * [in,out] key The key to search for in the database.
+ * [in,out] data The data corresponding to the key.
+ * [out] values_count The optional address to return number of values
+ * associated with given key, i.e.
+ * = 0 - in case MDBX_NOTFOUND error;
+ * = 1 - exactly for databases WITHOUT MDBX_DUPSORT;
+ * >= 1 for databases WITH MDBX_DUPSORT.
+ *
+ * Returns A non-zero error value on failure and 0 on success, some
+ * possible errors are:
+ * - MDBX_NOTFOUND = the key was not in the database.
+ * - MDBX_EINVAL = an invalid parameter was specified. */
+LIBMDBX_API int mdbx_get_ex(MDBX_txn *txn, MDBX_dbi dbi, MDBX_val *key,
+ MDBX_val *data, size_t *values_count);
+
+/* Get nearest items from a database.
+ *
+ * Briefly this function does the same as mdbx_get() with a few differences:
+ * 1. Return nearest (i.e. equal or great due comparison function) key-value
+ * pair, but not only exactly matching with the key.
+ * 2. On success return MDBX_SUCCESS if key found exactly,
+ * and MDBX_RESULT_TRUE otherwise. Moreover, for databases with MDBX_DUPSORT
+ * flag the data argument also will be used to match over
+ * multi-value/duplicates, and MDBX_SUCCESS will be returned only when BOTH
+ * the key and the data match exactly.
+ * 3. Updates BOTH the key and the data for pointing to the actual key-value
+ * pair inside the database.
+ *
+ * [in] txn A transaction handle returned by mdbx_txn_begin().
+ * [in] dbi A database handle returned by mdbx_dbi_open().
+ * [in,out] key The key to search for in the database.
+ * [in,out] data The data corresponding to the key.
+ *
+ * Returns A non-zero error value on failure and MDBX_RESULT_TRUE (0) or
+ * MDBX_RESULT_TRUE on success (as described above).
+ * Some possible errors are:
+ * - MDBX_NOTFOUND = the key was not in the database.
+ * - MDBX_EINVAL = an invalid parameter was specified. */
+LIBMDBX_API int mdbx_get_nearest(MDBX_txn *txn, MDBX_dbi dbi, MDBX_val *key,
+ MDBX_val *data);
+
+/* Store items into a database.
+ *
+ * This function stores key/data pairs in the database. The default behavior
+ * is to enter the new key/data pair, replacing any previously existing key
+ * if duplicates are disallowed, or adding a duplicate data item if
+ * duplicates are allowed (MDBX_DUPSORT).
+ *
+ * [in] txn A transaction handle returned by mdbx_txn_begin().
+ * [in] dbi A database handle returned by mdbx_dbi_open().
+ * [in] key The key to store in the database.
+ * [in,out] data The data to store.
+ * [in] flags Special options for this operation. This parameter must be
+ * set to 0 or by bitwise OR'ing together one or more of the
+ * values described here.
+ *
+ * - MDBX_NODUPDATA
+ * Enter the new key/data pair only if it does not already appear
+ * in the database. This flag may only be specified if the database
+ * was opened with MDBX_DUPSORT. The function will return MDBX_KEYEXIST
+ * if the key/data pair already appears in the database.
+ *
+ * - MDBX_NOOVERWRITE
+ * Enter the new key/data pair only if the key does not already appear
+ * in the database. The function will return MDBX_KEYEXIST if the key
+ * already appears in the database, even if the database supports
+ * duplicates (MDBX_DUPSORT). The data parameter will be set to point
+ * to the existing item.
+ *
+ * - MDBX_CURRENT
+ * Update an single existing entry, but not add new ones. The function
+ * will return MDBX_NOTFOUND if the given key not exist in the database.
+ * Or the MDBX_EMULTIVAL in case duplicates for the given key.
+ *
+ * - MDBX_RESERVE
+ * Reserve space for data of the given size, but don't copy the given
+ * data. Instead, return a pointer to the reserved space, which the
+ * caller can fill in later - before the next update operation or the
+ * transaction ends. This saves an extra memcpy if the data is being
+ * generated later. MDBX does nothing else with this memory, the caller
+ * is expected to modify all of the space requested. This flag must not
+ * be specified if the database was opened with MDBX_DUPSORT.
+ *
+ * - MDBX_APPEND
+ * Append the given key/data pair to the end of the database. This option
+ * allows fast bulk loading when keys are already known to be in the
+ * correct order. Loading unsorted keys with this flag will cause
+ * a MDBX_EKEYMISMATCH error.
+ *
+ * - MDBX_APPENDDUP
+ * As above, but for sorted dup data.
+ *
+ * Returns A non-zero error value on failure and 0 on success, some
+ * possible errors are:
+ * - MDBX_KEYEXIST
+ * - MDBX_MAP_FULL = the database is full, see mdbx_env_set_mapsize().
+ * - MDBX_TXN_FULL = the transaction has too many dirty pages.
+ * - MDBX_EACCES = an attempt was made to write in a read-only transaction.
+ * - MDBX_EINVAL = an invalid parameter was specified. */
+LIBMDBX_API int mdbx_put(MDBX_txn *txn, MDBX_dbi dbi, MDBX_val *key,
+ MDBX_val *data, unsigned flags);
+
+/* Replace items in a database.
+ *
+ * This function allows to update or delete an existing value at the same time
+ * as the previous value is retrieved. If the argument new_data equal is NULL
+ * zero, the removal is performed, otherwise the update/insert.
+ *
+ * The current value may be in an already changed (aka dirty) page. In this
+ * case, the page will be overwritten during the update, and the old value will
+ * be lost. Therefore, an additional buffer must be passed via old_data argument
+ * initially to copy the old value. If the buffer passed in is too small, the
+ * function will return MDBX_RESULT_TRUE (-1) by setting iov_len field pointed
+ * by old_data argument to the appropriate value, without performing any
+ * changes.
+ *
+ * For databases with non-unique keys (i.e. with MDBX_DUPSORT flag), another use
+ * case is also possible, when by old_data argument selects a specific item from
+ * multi-value/duplicates with the same key for deletion or update. To select
+ * this scenario in flags should simultaneously specify MDBX_CURRENT and
+ * MDBX_NOOVERWRITE. This combination is chosen because it makes no sense, and
+ * thus allows you to identify the request of such a scenario.
+ *
+ * [in] txn A transaction handle returned by mdbx_txn_begin().
+ * [in] dbi A database handle returned by mdbx_dbi_open().
+ * [in] key The key to store in the database.
+ * [in,out] new_data The data to store, if NULL then deletion will be
+ * performed.
+ * [in,out] old_data The buffer for retrieve previous value as describe
+ * above.
+ * [in] flags Special options for this operation. This parameter must
+ * be set to 0 or by bitwise OR'ing together one or more of
+ * the values described in mdbx_put() description above,
+ * and additionally (MDBX_CURRENT | MDBX_NOOVERWRITE)
+ * combination for selection particular item from
+ * multi-value/duplicates.
+ *
+ * Returns A non-zero error value on failure and 0 on success. */
+LIBMDBX_API int mdbx_replace(MDBX_txn *txn, MDBX_dbi dbi, MDBX_val *key,
+ MDBX_val *new_data, MDBX_val *old_data,
+ unsigned flags);
+
+/* Delete items from a database.
+ *
+ * This function removes key/data pairs from the database.
+ *
+ * NOTE: The data parameter is NOT ignored regardless the database does
+ * support sorted duplicate data items or not. If the data parameter
+ * is non-NULL only the matching data item will be deleted.
+ *
+ * This function will return MDBX_NOTFOUND if the specified key/data
+ * pair is not in the database.
+ *
+ * [in] txn A transaction handle returned by mdbx_txn_begin().
+ * [in] dbi A database handle returned by mdbx_dbi_open().
+ * [in] key The key to delete from the database.
+ * [in] data The data to delete.
+ *
+ * Returns A non-zero error value on failure and 0 on success, some
+ * possible errors are:
+ * - MDBX_EACCES = an attempt was made to write in a read-only transaction.
+ * - MDBX_EINVAL = an invalid parameter was specified. */
+LIBMDBX_API int mdbx_del(MDBX_txn *txn, MDBX_dbi dbi, MDBX_val *key,
+ MDBX_val *data);
+
+/* Create a cursor handle.
+ *
+ * A cursor is associated with a specific transaction and database. A cursor
+ * cannot be used when its database handle is closed. Nor when its transaction
+ * has ended, except with mdbx_cursor_renew(). Also it can be discarded with
+ * mdbx_cursor_close().
+ *
+ * A cursor must be closed explicitly always, before or after its transaction
+ * ends. It can be reused with mdbx_cursor_renew() before finally closing it.
+ *
+ * NOTE: In contrast to LMDB, the MDBX required that any opened cursors can be
+ * reused and must be freed explicitly, regardless ones was opened in a
+ * read-only or write transaction. The REASON for this is eliminates ambiguity
+ * which helps to avoid errors such as: use-after-free, double-free, i.e. memory
+ * corruption and segfaults.
+ *
+ * [in] txn A transaction handle returned by mdbx_txn_begin().
+ * [in] dbi A database handle returned by mdbx_dbi_open().
+ * [out] cursor Address where the new MDBX_cursor handle will be stored.
+ *
+ * Returns A non-zero error value on failure and 0 on success, some
+ * possible errors are:
+ * - MDBX_EINVAL = an invalid parameter was specified. */
+LIBMDBX_API int mdbx_cursor_open(MDBX_txn *txn, MDBX_dbi dbi,
+ MDBX_cursor **cursor);
+
+/* Close a cursor handle.
+ *
+ * The cursor handle will be freed and must not be used again after this call,
+ * but its transaction may still be live.
+ *
+ * NOTE: In contrast to LMDB, the MDBX required that any opened cursors can be
+ * reused and must be freed explicitly, regardless ones was opened in a
+ * read-only or write transaction. The REASON for this is eliminates ambiguity
+ * which helps to avoid errors such as: use-after-free, double-free, i.e. memory
+ * corruption and segfaults.
+ *
+ * [in] cursor A cursor handle returned by mdbx_cursor_open(). */
+LIBMDBX_API void mdbx_cursor_close(MDBX_cursor *cursor);
+
+/* Renew a cursor handle.
+ *
+ * A cursor is associated with a specific transaction and database. The cursor
+ * may be associated with a new transaction, and referencing the same database
+ * handle as it was created with. This may be done whether the previous
+ * transaction is live or dead.
+ *
+ * NOTE: In contrast to LMDB, the MDBX allow any cursor to be re-used by using
+ * mdbx_cursor_renew(), to avoid unnecessary malloc/free overhead until it freed
+ * by mdbx_cursor_close().
+ *
+ * [in] txn A transaction handle returned by mdbx_txn_begin().
+ * [in] cursor A cursor handle returned by mdbx_cursor_open().
+ *
+ * Returns A non-zero error value on failure and 0 on success, some
+ * possible errors are:
+ * - MDBX_EINVAL = an invalid parameter was specified. */
+LIBMDBX_API int mdbx_cursor_renew(MDBX_txn *txn, MDBX_cursor *cursor);
+
+/* Return the cursor's transaction handle.
+ *
+ * [in] cursor A cursor handle returned by mdbx_cursor_open(). */
+LIBMDBX_API MDBX_txn *mdbx_cursor_txn(MDBX_cursor *cursor);
+
+/* Return the cursor's database handle.
+ *
+ * [in] cursor A cursor handle returned by mdbx_cursor_open(). */
+LIBMDBX_API MDBX_dbi mdbx_cursor_dbi(MDBX_cursor *cursor);
+
+/* Retrieve by cursor.
+ *
+ * This function retrieves key/data pairs from the database. The address and
+ * length of the key are returned in the object to which key refers (except
+ * for the case of the MDBX_SET option, in which the key object is unchanged),
+ * and the address and length of the data are returned in the object to which
+ * data refers. See mdbx_get() for restrictions on using the output values.
+ *
+ * [in] cursor A cursor handle returned by mdbx_cursor_open().
+ * [in,out] key The key for a retrieved item.
+ * [in,out] data The data of a retrieved item.
+ * [in] op A cursor operation MDBX_cursor_op.
+ *
+ * Returns A non-zero error value on failure and 0 on success, some
+ * possible errors are:
+ * - MDBX_NOTFOUND = no matching key found.
+ * - MDBX_EINVAL = an invalid parameter was specified. */
+LIBMDBX_API int mdbx_cursor_get(MDBX_cursor *cursor, MDBX_val *key,
+ MDBX_val *data, MDBX_cursor_op op);
+
+/* Store by cursor.
+ *
+ * This function stores key/data pairs into the database. The cursor is
+ * positioned at the new item, or on failure usually near it.
+ *
+ * [in] cursor A cursor handle returned by mdbx_cursor_open().
+ * [in] key The key operated on.
+ * [in] data The data operated on.
+ * [in] flags Options for this operation. This parameter
+ * must be set to 0 or one of the values described here:
+ *
+ * - MDBX_CURRENT
+ * Replace the item at the current cursor position. The key parameter
+ * must still be provided, and must match it, otherwise the function
+ * return MDBX_EKEYMISMATCH.
+ *
+ * NOTE: MDBX unlike LMDB allows you to change the size of the data and
+ * automatically handles reordering for sorted duplicates (MDBX_DUPSORT).
+ *
+ * - MDBX_NODUPDATA
+ * Enter the new key/data pair only if it does not already appear in the
+ * database. This flag may only be specified if the database was opened
+ * with MDBX_DUPSORT. The function will return MDBX_KEYEXIST if the
+ * key/data pair already appears in the database.
+ *
+ * - MDBX_NOOVERWRITE
+ * Enter the new key/data pair only if the key does not already appear
+ * in the database. The function will return MDBX_KEYEXIST if the key
+ * already appears in the database, even if the database supports
+ * duplicates (MDBX_DUPSORT).
+ *
+ * - MDBX_RESERVE
+ * Reserve space for data of the given size, but don't copy the given
+ * data. Instead, return a pointer to the reserved space, which the
+ * caller can fill in later - before the next update operation or the
+ * transaction ends. This saves an extra memcpy if the data is being
+ * generated later. This flag must not be specified if the database
+ * was opened with MDBX_DUPSORT.
+ *
+ * - MDBX_APPEND
+ * Append the given key/data pair to the end of the database. No key
+ * comparisons are performed. This option allows fast bulk loading when
+ * keys are already known to be in the correct order. Loading unsorted
+ * keys with this flag will cause a MDBX_KEYEXIST error.
+ *
+ * - MDBX_APPENDDUP
+ * As above, but for sorted dup data.
+ *
+ * - MDBX_MULTIPLE
+ * Store multiple contiguous data elements in a single request. This flag
+ * may only be specified if the database was opened with MDBX_DUPFIXED.
+ * The data argument must be an array of two MDBX_vals. The iov_len of the
+ * first MDBX_val must be the size of a single data element. The iov_base
+ * of the first MDBX_val must point to the beginning of the array of
+ * contiguous data elements. The iov_len of the second MDBX_val must be
+ * the count of the number of data elements to store. On return this
+ * field will be set to the count of the number of elements actually
+ * written. The iov_base of the second MDBX_val is unused.
+ *
+ * Returns A non-zero error value on failure and 0 on success, some
+ * possible errors are:
+ * - MDBX_EKEYMISMATCH
+ * - MDBX_MAP_FULL = the database is full, see mdbx_env_set_mapsize().
+ * - MDBX_TXN_FULL = the transaction has too many dirty pages.
+ * - MDBX_EACCES = an attempt was made to write in a read-only transaction.
+ * - MDBX_EINVAL = an invalid parameter was specified. */
+LIBMDBX_API int mdbx_cursor_put(MDBX_cursor *cursor, MDBX_val *key,
+ MDBX_val *data, unsigned flags);
+
+/* Delete current key/data pair.
+ *
+ * This function deletes the key/data pair to which the cursor refers. This does
+ * not invalidate the cursor, so operations such as MDBX_NEXT can still be used
+ * on it. Both MDBX_NEXT and MDBX_GET_CURRENT will return the same record after
+ * this operation.
+ *
+ * [in] cursor A cursor handle returned by mdbx_cursor_open().
+ * [in] flags Options for this operation. This parameter must be set to 0
+ * or one of the values described here.
+ *
+ * - MDBX_NODUPDATA
+ * Delete all of the data items for the current key. This flag may only
+ * be specified if the database was opened with MDBX_DUPSORT.
+ *
+ * Returns A non-zero error value on failure and 0 on success, some
+ * possible errors are:
+ * - MDBX_EACCES = an attempt was made to write in a read-only transaction.
+ * - MDBX_EINVAL = an invalid parameter was specified. */
+LIBMDBX_API int mdbx_cursor_del(MDBX_cursor *cursor, unsigned flags);
+
+/* Return count of duplicates for current key.
+ *
+ * This call is valid for all databases, but reasonable only for that support
+ * sorted duplicate data items MDBX_DUPSORT.
+ *
+ * [in] cursor A cursor handle returned by mdbx_cursor_open().
+ * [out] countp Address where the count will be stored.
+ *
+ * Returns A non-zero error value on failure and 0 on success, some
+ * possible errors are:
+ * - MDBX_EINVAL = cursor is not initialized, or an invalid parameter
+ * was specified. */
+LIBMDBX_API int mdbx_cursor_count(MDBX_cursor *cursor, size_t *countp);
+
+/* Determines whether the cursor is pointed to a key-value pair or not,
+ * i.e. was not positioned or points to the end of data.
+ *
+ * [in] cursor A cursor handle returned by mdbx_cursor_open().
+ *
+ * Returns:
+ * - MDBX_RESULT_TRUE = no more data available or cursor not positioned;
+ * - MDBX_RESULT_FALSE = data available;
+ * - Otherwise the error code. */
+LIBMDBX_API int mdbx_cursor_eof(MDBX_cursor *mc);
+
+/* Determines whether the cursor is pointed to the first key-value pair or not.
+ *
+ * [in] cursor A cursor handle returned by mdbx_cursor_open().
+ *
+ * Returns:
+ * - MDBX_RESULT_TRUE = cursor positioned to the first key-value pair.
+ * - MDBX_RESULT_FALSE = cursor NOT positioned to the first key-value pair.
+ * - Otherwise the error code. */
+LIBMDBX_API int mdbx_cursor_on_first(MDBX_cursor *mc);
+
+/* Determines whether the cursor is pointed to the last key-value pair or not.
+ *
+ * [in] cursor A cursor handle returned by mdbx_cursor_open().
+ *
+ * Returns:
+ * - MDBX_RESULT_TRUE = cursor positioned to the last key-value pair.
+ * - MDBX_RESULT_FALSE = cursor NOT positioned to the last key-value pair.
+ * - Otherwise the error code. */
+LIBMDBX_API int mdbx_cursor_on_last(MDBX_cursor *mc);
+
+/* Estimates the distance between cursors as a number of elements. The results
+ * of such estimation can be used to build and/or optimize query execution
+ * plans.
+ *
+ * This function performs a rough estimate based only on b-tree pages that are
+ * common for the both cursor's stacks.
+ *
+ * NOTE: The result varies greatly depending on the filling of specific pages
+ * and the overall balance of the b-tree:
+ *
+ * 1. The number of items is estimated by analyzing the height and fullness of
+ * the b-tree. The accuracy of the result directly depends on the balance of the
+ * b-tree, which in turn is determined by the history of previous insert/delete
+ * operations and the nature of the data (i.e. variability of keys length and so
+ * on). Therefore, the accuracy of the estimation can vary greatly in a
+ * particular situation.
+ *
+ * 2. To understand the potential spread of results, you should consider a
+ * possible situations basing on the general criteria for splitting and merging
+ * b-tree pages:
+ * - the page is split into two when there is no space for added data;
+ * - two pages merge if the result fits in half a page;
+ * - thus, the b-tree can consist of an arbitrary combination of pages filled
+ * both completely and only 1/4. Therefore, in the worst case, the result
+ * can diverge 4 times for each level of the b-tree excepting the first and
+ * the last.
+ *
+ * 3. In practice, the probability of extreme cases of the above situation is
+ * close to zero and in most cases the error does not exceed a few percent. On
+ * the other hand, it's just a chance you shouldn't overestimate.
+ *
+ * Both cursors must be initialized for the same database and the same
+ * transaction.
+ *
+ * [in] first The first cursor for estimation.
+ * [in] last The second cursor for estimation.
+ * [out] distance_items A pointer to store estimated distance value,
+ * i.e. *distance_items = distance(first, last).
+ *
+ * Returns A non-zero error value on failure and 0 on success. */
+LIBMDBX_API int mdbx_estimate_distance(const MDBX_cursor *first,
+ const MDBX_cursor *last,
+ ptrdiff_t *distance_items);
+
+/* Estimates the move distance, i.e. between the current cursor position and
+ * next position after the specified move-operation with given key and data.
+ * The results of such estimation can be used to build and/or optimize query
+ * execution plans. Current cursor position and state are preserved.
+ *
+ * Please see notes on accuracy of the result in mdbx_estimate_distance()
+ * description above.
+ *
+ * [in] cursor Cursor for estimation.
+ * [in,out] key The key for a retrieved item.
+ * [in,out] data The data of a retrieved item.
+ * [in] op A cursor operation MDBX_cursor_op.
+ * [out] distance_items A pointer to store estimated move distance
+ * as the number of elements.
+ *
+ * Returns A non-zero error value on failure and 0 on success. */
+LIBMDBX_API int mdbx_estimate_move(const MDBX_cursor *cursor, MDBX_val *key,
+ MDBX_val *data, MDBX_cursor_op move_op,
+ ptrdiff_t *distance_items);
+
+/* Estimates the size of a range as a number of elements. The results
+ * of such estimation can be used to build and/or optimize query execution
+ * plans.
+ *
+ * Please see notes on accuracy of the result in mdbx_estimate_distance()
+ * description above.
+ *
+ * [in] txn A transaction handle returned by mdbx_txn_begin().
+ * [in] dbi A database handle returned by mdbx_dbi_open().
+ * [in] begin_key The key of range beginning or NULL for explicit FIRST.
+ * [in] begin_data Optional additional data to seeking among sorted
+ * duplicates. Only for MDBX_DUPSORT, NULL otherwise.
+ * [in] end_key The key of range ending or NULL for explicit LAST.
+ * [in] end_data Optional additional data to seeking among sorted
+ * duplicates. Only for MDBX_DUPSORT, NULL otherwise.
+ * [out] distance_items A pointer to store range estimation result.
+ *
+ * Returns A non-zero error value on failure and 0 on success. */
+#define MDBX_EPSILON ((MDBX_val *)((ptrdiff_t)-1))
+LIBMDBX_API int mdbx_estimate_range(MDBX_txn *txn, MDBX_dbi dbi,
+ MDBX_val *begin_key, MDBX_val *begin_data,
+ MDBX_val *end_key, MDBX_val *end_data,
+ ptrdiff_t *size_items);
+
+/* Determines whether the given address is on a dirty database page of the
+ * transaction or not. Ultimately, this allows to avoid copy data from non-dirty
+ * pages.
+ *
+ * "Dirty" pages are those that have already been changed during a write
+ * transaction. Accordingly, any further changes may result in such pages being
+ * overwritten. Therefore, all functions libmdbx performing changes inside the
+ * database as arguments should NOT get pointers to data in those pages. In
+ * turn, "not dirty" pages before modification will be copied.
+ *
+ * In other words, data from dirty pages must either be copied before being
+ * passed as arguments for further processing or rejected at the argument
+ * validation stage. Thus, mdbx_is_dirty() allows you to get rid of unnecessary
+ * copying, and perform a more complete check of the arguments.
+ *
+ * NOTE: The address passed must point to the beginning of the data. This is the
+ * only way to ensure that the actual page header is physically located in the
+ * same memory page, including for multi-pages with long data.
+ *
+ * NOTE: In rare cases the function may return a false positive answer
+ * (DBX_RESULT_TRUE when data is NOT on a dirty page), but never a false
+ * negative if the arguments are correct.
+ *
+ * [in] txn A transaction handle returned by mdbx_txn_begin().
+ * [in] ptr The address of data to check.
+ *
+ * Returns:
+ * - MDBX_RESULT_TRUE = given address is on the dirty page.
+ * - MDBX_RESULT_FALSE = given address is NOT on the dirty page.
+ * - Otherwise the error code. */
+LIBMDBX_API int mdbx_is_dirty(const MDBX_txn *txn, const void *ptr);
+
+/* Sequence generation for a database.
+ *
+ * The function allows to create a linear sequence of unique positive integers
+ * for each database. The function can be called for a read transaction to
+ * retrieve the current sequence value, and the increment must be zero.
+ * Sequence changes become visible outside the current write transaction after
+ * it is committed, and discarded on abort.
+ *
+ * [in] txn A transaction handle returned by mdbx_txn_begin().
+ * [in] dbi A database handle returned by mdbx_dbi_open().
+ * [out] result The optional address where the value of sequence before the
+ * change will be stored.
+ * [in] increment Value to increase the sequence,
+ * must be 0 for read-only transactions.
+ *
+ * Returns A non-zero error value on failure and 0 on success, some
+ * possible errors are:
+ * - MDBX_RESULT_TRUE = Increasing the sequence has resulted in an overflow
+ * and therefore cannot be executed. */
+LIBMDBX_API int mdbx_dbi_sequence(MDBX_txn *txn, MDBX_dbi dbi, uint64_t *result,
+ uint64_t increment);
+
+/* Compare two data items according to a particular database.
+ *
+ * This returns a comparison as if the two data items were keys in the
+ * specified database.
+ *
+ * [in] txn A transaction handle returned by mdbx_txn_begin().
+ * [in] dbi A database handle returned by mdbx_dbi_open().
+ * [in] a The first item to compare.
+ * [in] b The second item to compare.
+ *
+ * Returns < 0 if a < b, 0 if a == b, > 0 if a > b */
+LIBMDBX_API int mdbx_cmp(MDBX_txn *txn, MDBX_dbi dbi, const MDBX_val *a,
+ const MDBX_val *b);
+
+/* Compare two data items according to a particular database.
+ *
+ * This returns a comparison as if the two items were data items of the
+ * specified database. The database must have the MDBX_DUPSORT flag.
+ *
+ * [in] txn A transaction handle returned by mdbx_txn_begin().
+ * [in] dbi A database handle returned by mdbx_dbi_open().
+ * [in] a The first item to compare.
+ * [in] b The second item to compare.
+ *
+ * Returns < 0 if a < b, 0 if a == b, > 0 if a > b */
+LIBMDBX_API int mdbx_dcmp(MDBX_txn *txn, MDBX_dbi dbi, const MDBX_val *a,
+ const MDBX_val *b);
+
+/* A callback function used to enumerate the reader lock table.
+ *
+ * [in] ctx An arbitrary context pointer for the callback.
+ * [in] num The serial number during enumeration, starting from 1.
+ * [in] slot The reader lock table slot number.
+ * [in] txnid The ID of the transaction being read,
+ * i.e. the MVCC-snaphot number.
+ * [in] lag The lag from a recent MVCC-snapshot, i.e. the number of
+ * committed transaction since read transaction started.
+ * [in] pid The reader process ID.
+ * [in] thread The reader thread ID.
+ * [in] bytes_used The number of last used page in the MVCC-snapshot which
+ * being read, i.e. database file can't shrinked beyond this.
+ * [in] bytes_retired The total size of the database pages that were retired by
+ * committed write transactions after the reader's
+ * MVCC-snapshot, i.e. the space which would be freed after
+ * the Reader releases the MVCC-snapshot for reuse by
+ * completion read transaction.
+ *
+ * Returns < 0 on failure, >= 0 on success. */
+typedef int(MDBX_reader_list_func)(void *ctx, int num, int slot, mdbx_pid_t pid,
+ mdbx_tid_t thread, uint64_t txnid,
+ uint64_t lag, size_t bytes_used,
+ size_t bytes_retained);
+
+/* Enumarete the entries in the reader lock table.
+ *
+ * [in] env An environment handle returned by mdbx_env_create().
+ * [in] func A MDBX_reader_list_func function.
+ * [in] ctx An arbitrary context pointer for the enumeration function.
+ *
+ * Returns A non-zero error value on failure and 0 on success,
+ * or MDBX_RESULT_TRUE (-1) if the reader lock table is empty. */
+LIBMDBX_API int mdbx_reader_list(MDBX_env *env, MDBX_reader_list_func *func,
+ void *ctx);
+
+/* Check for stale entries in the reader lock table.
+ *
+ * [in] env An environment handle returned by mdbx_env_create().
+ * [out] dead Number of stale slots that were cleared.
+ *
+ * Returns A non-zero error value on failure and 0 on success,
+ * or MDBX_RESULT_TRUE (-1) if a dead reader(s) found or mutex was recovered. */
+LIBMDBX_API int mdbx_reader_check(MDBX_env *env, int *dead);
+
+/* Returns a lag of the reading for the given transaction.
+ *
+ * Returns an information for estimate how much given read-only
+ * transaction is lagging relative the to actual head.
+ *
+ * [in] txn A transaction handle returned by mdbx_txn_begin().
+ * [out] percent Percentage of page allocation in the database.
+ *
+ * Returns Number of transactions committed after the given was started for
+ * read, or negative value on failure. */
+LIBMDBX_API int mdbx_txn_straggler(MDBX_txn *txn, int *percent);
+
+/* A lack-of-space callback function to resolve issues with a laggard readers.
+ *
+ * Read transactions prevent reuse of pages freed by newer write transactions,
+ * thus the database can grow quickly. This callback will be called when there
+ * is not enough space in the database (ie. before increasing the database size
+ * or before MDBX_MAP_FULL error) and thus can be used to resolve issues with
+ * a "long-lived" read transactions.
+ *
+ * Depending on the arguments and needs, your implementation may wait, terminate
+ * a process or thread that is performing a long read, or perform some other
+ * action. In doing so it is important that the returned code always corresponds
+ * to the performed action.
+ *
+ * [in] env An environment handle returned by mdbx_env_create().
+ * [in] pid A pid of the reader process.
+ * [in] tid A thread_id of the reader thread.
+ * [in] txn A transaction number on which stalled.
+ * [in] gap A lag from the last commited txn.
+ * [in] space A space that actually become available for reuse after this
+ * reader finished. The callback function can take this value into
+ * account to evaluate the impact that a long-running transaction
+ * has.
+ * [in] retry A retry number starting from 0. if callback has returned 0
+ * at least once, then at end of current OOM-handler loop callback
+ * will be called additionally with negative value to notify about
+ * the end of loop. The callback function can use this value to
+ * implement timeout logic while waiting for readers.
+ *
+ * The RETURN CODE determines the further actions libmdbx and must match the
+ * action which was executed by the callback:
+ *
+ * -2 or less = An error condition and the reader was not killed.
+ *
+ * -1 = The callback was unable to solve the problem and agreed
+ * on MDBX_MAP_FULL error, libmdbx should increase the
+ * database size or return MDBX_MAP_FULL error.
+ *
+ * 0 (zero) = The callback solved the problem or just waited for
+ * a while, libmdbx should rescan the reader lock table and
+ * retry. This also includes a situation when corresponding
+ * transaction terminated in normal way by mdbx_txn_abort()
+ * or mdbx_txn_reset(), and my be restarted. I.e. reader
+ * slot don't needed to be cleaned from transaction.
+ *
+ * 1 = Transaction aborted asynchronous and reader slot should
+ * be cleared immediately, i.e. read transaction will not
+ * continue but mdbx_txn_abort() or mdbx_txn_reset() will
+ * be called later.
+ *
+ * 2 or great = The reader process was terminated or killed, and libmdbx
+ * should entirely reset reader registration. */
+typedef int(MDBX_oom_func)(MDBX_env *env, mdbx_pid_t pid, mdbx_tid_t tid,
+ uint64_t txn, unsigned gap, size_t space, int retry);
+
+/* Set the OOM callback.
+ *
+ * The callback will only be triggered on lack of space to resolve issues with
+ * lagging reader(s) (i.e. to kill it) for resume reuse pages from the garbage
+ * collector.
+ *
+ * [in] env An environment handle returned by mdbx_env_create().
+ * [in] oom_func A MDBX_oom_func function or NULL to disable.
+ *
+ * Returns A non-zero error value on failure and 0 on success. */
+LIBMDBX_API int mdbx_env_set_oomfunc(MDBX_env *env, MDBX_oom_func *oom_func);
+
+/* Get the current oom_func callback.
+ *
+ * [in] env An environment handle returned by mdbx_env_create().
+ *
+ * Returns A MDBX_oom_func function or NULL if disabled. */
+LIBMDBX_API MDBX_oom_func *mdbx_env_get_oomfunc(MDBX_env *env);
+
+/**** B-tree Traversal *********************************************************
+ * This is internal API for mdbx_chk tool. You should avoid to use it, except
+ * some extremal special cases. */
+
+/* Page types for traverse the b-tree. */
+typedef enum {
+ MDBX_page_void,
+ MDBX_page_meta,
+ MDBX_page_large,
+ MDBX_page_branch,
+ MDBX_page_leaf,
+ MDBX_page_dupfixed_leaf,
+ MDBX_subpage_leaf,
+ MDBX_subpage_dupfixed_leaf
+} MDBX_page_type_t;
+
+#define MDBX_PGWALK_MAIN ((const char *)((ptrdiff_t)0))
+#define MDBX_PGWALK_GC ((const char *)((ptrdiff_t)-1))
+#define MDBX_PGWALK_META ((const char *)((ptrdiff_t)-2))
+
+/* Callback function for traverse the b-tree. */
+typedef int
+MDBX_pgvisitor_func(const uint64_t pgno, const unsigned number, void *const ctx,
+ const int deep, const char *const dbi,
+ const size_t page_size, const MDBX_page_type_t type,
+ const size_t nentries, const size_t payload_bytes,
+ const size_t header_bytes, const size_t unused_bytes);
+
+/* B-tree traversal function. */
+LIBMDBX_API int mdbx_env_pgwalk(MDBX_txn *txn, MDBX_pgvisitor_func *visitor,
+ void *ctx);
+
+/**** Attribute support functions for Nexenta *********************************/
+#ifdef MDBX_NEXENTA_ATTRS
+typedef uint_fast64_t mdbx_attr_t;
+
+/* Store by cursor with attribute.
+ *
+ * This function stores key/data pairs into the database. The cursor is
+ * positioned at the new item, or on failure usually near it.
+ *
+ * NOTE: Internally based on MDBX_RESERVE feature,
+ * therefore doesn't support MDBX_DUPSORT.
+ *
+ * [in] cursor A cursor handle returned by mdbx_cursor_open()
+ * [in] key The key operated on.
+ * [in] data The data operated on.
+ * [in] attr The attribute.
+ * [in] flags Options for this operation. This parameter must be set to 0
+ * or one of the values described here:
+ *
+ * - MDBX_CURRENT
+ * Replace the item at the current cursor position. The key parameter
+ * must still be provided, and must match it, otherwise the function
+ * return MDBX_EKEYMISMATCH.
+ *
+ * - MDBX_APPEND
+ * Append the given key/data pair to the end of the database. No key
+ * comparisons are performed. This option allows fast bulk loading when
+ * keys are already known to be in the correct order. Loading unsorted
+ * keys with this flag will cause a MDBX_KEYEXIST error.
+ *
+ * Returns A non-zero error value on failure and 0 on success, some
+ * possible errors are:
+ * - MDBX_EKEYMISMATCH
+ * - MDBX_MAP_FULL = the database is full, see mdbx_env_set_mapsize().
+ * - MDBX_TXN_FULL = the transaction has too many dirty pages.
+ * - MDBX_EACCES = an attempt was made to write in a read-only transaction.
+ * - MDBX_EINVAL = an invalid parameter was specified. */
+LIBMDBX_API int mdbx_cursor_put_attr(MDBX_cursor *cursor, MDBX_val *key,
+ MDBX_val *data, mdbx_attr_t attr,
+ unsigned flags);
+
+/* Store items and attributes into a database.
+ *
+ * This function stores key/data pairs in the database. The default behavior
+ * is to enter the new key/data pair, replacing any previously existing key
+ * if duplicates are disallowed.
+ *
+ * NOTE: Internally based on MDBX_RESERVE feature,
+ * therefore doesn't support MDBX_DUPSORT.
+ *
+ * [in] txn A transaction handle returned by mdbx_txn_begin().
+ * [in] dbi A database handle returned by mdbx_dbi_open().
+ * [in] key The key to store in the database.
+ * [in] attr The attribute to store in the database.
+ * [in,out] data The data to store.
+ * [in] flags Special options for this operation. This parameter must be
+ * set to 0 or by bitwise OR'ing together one or more of the
+ * values described here:
+ *
+ * - MDBX_NOOVERWRITE
+ * Enter the new key/data pair only if the key does not already appear
+ * in the database. The function will return MDBX_KEYEXIST if the key
+ * already appears in the database. The data parameter will be set to
+ * point to the existing item.
+ *
+ * - MDBX_CURRENT
+ * Update an single existing entry, but not add new ones. The function
+ * will return MDBX_NOTFOUND if the given key not exist in the database.
+ * Or the MDBX_EMULTIVAL in case duplicates for the given key.
+ *
+ * - MDBX_APPEND
+ * Append the given key/data pair to the end of the database. This option
+ * allows fast bulk loading when keys are already known to be in the
+ * correct order. Loading unsorted keys with this flag will cause
+ * a MDBX_EKEYMISMATCH error.
+ *
+ * Returns A non-zero error value on failure and 0 on success, some
+ * possible errors are:
+ * - MDBX_KEYEXIST
+ * - MDBX_MAP_FULL = the database is full, see mdbx_env_set_mapsize().
+ * - MDBX_TXN_FULL = the transaction has too many dirty pages.
+ * - MDBX_EACCES = an attempt was made to write in a read-only transaction.
+ * - MDBX_EINVAL = an invalid parameter was specified. */
+LIBMDBX_API int mdbx_put_attr(MDBX_txn *txn, MDBX_dbi dbi, MDBX_val *key,
+ MDBX_val *data, mdbx_attr_t attr, unsigned flags);
+
+/* Set items attribute from a database.
+ *
+ * This function stores key/data pairs attribute to the database.
+ *
+ * NOTE: Internally based on MDBX_RESERVE feature,
+ * therefore doesn't support MDBX_DUPSORT.
+ *
+ * [in] txn A transaction handle returned by mdbx_txn_begin().
+ * [in] dbi A database handle returned by mdbx_dbi_open().
+ * [in] key The key to search for in the database.
+ * [in] data The data to be stored or NULL to save previous value.
+ * [in] attr The attribute to be stored.
+ *
+ * Returns A non-zero error value on failure and 0 on success, some
+ * possible errors are:
+ * - MDBX_NOTFOUND = the key-value pair was not in the database.
+ * - MDBX_EINVAL = an invalid parameter was specified. */
+LIBMDBX_API int mdbx_set_attr(MDBX_txn *txn, MDBX_dbi dbi, MDBX_val *key,
+ MDBX_val *data, mdbx_attr_t attr);
+
+/* Get items attribute from a database cursor.
+ *
+ * This function retrieves key/data pairs from the database. The address and
+ * length of the key are returned in the object to which key refers (except
+ * for the case of the MDBX_SET option, in which the key object is unchanged),
+ * and the address and length of the data are returned in the object to which
+ * data refers. See mdbx_get() for restrictions on using the output values.
+ *
+ * [in] cursor A cursor handle returned by mdbx_cursor_open().
+ * [in,out] key The key for a retrieved item.
+ * [in,out] data The data of a retrieved item.
+ * [in] op A cursor operation MDBX_cursor_op.
+ *
+ * Returns A non-zero error value on failure and 0 on success, some
+ * possible errors are:
+ * - MDBX_NOTFOUND = no matching key found.
+ * - MDBX_EINVAL = an invalid parameter was specified. */
+LIBMDBX_API int mdbx_cursor_get_attr(MDBX_cursor *mc, MDBX_val *key,
+ MDBX_val *data, mdbx_attr_t *attrptr,
+ MDBX_cursor_op op);
+
+/* Get items attribute from a database.
+ *
+ * This function retrieves key/data pairs from the database. The address
+ * and length of the data associated with the specified key are returned
+ * in the structure to which data refers.
+ * If the database supports duplicate keys (MDBX_DUPSORT) then the
+ * first data item for the key will be returned. Retrieval of other
+ * items requires the use of mdbx_cursor_get().
+ *
+ * NOTE: The memory pointed to by the returned values is owned by the
+ * database. The caller need not dispose of the memory, and may not
+ * modify it in any way. For values returned in a read-only transaction
+ * any modification attempts will cause a SIGSEGV.
+ *
+ * NOTE: Values returned from the database are valid only until a
+ * subsequent update operation, or the end of the transaction.
+ *
+ * [in] txn A transaction handle returned by mdbx_txn_begin().
+ * [in] dbi A database handle returned by mdbx_dbi_open().
+ * [in] key The key to search for in the database.
+ * [in,out] data The data corresponding to the key.
+ *
+ * Returns A non-zero error value on failure and 0 on success, some
+ * possible errors are:
+ * - MDBX_NOTFOUND = the key was not in the database.
+ * - MDBX_EINVAL = an invalid parameter was specified. */
+LIBMDBX_API int mdbx_get_attr(MDBX_txn *txn, MDBX_dbi dbi, MDBX_val *key,
+ MDBX_val *data, mdbx_attr_t *attrptr);
+#endif /* MDBX_NEXENTA_ATTRS */
+
+/*******************************************************************************
+ * LY: temporary workaround for Elbrus's memcmp() bug. */
+#ifndef __GLIBC_PREREQ
+#if defined(__GLIBC__) && defined(__GLIBC_MINOR__)
+#define __GLIBC_PREREQ(maj, min) \
+ ((__GLIBC__ << 16) + __GLIBC_MINOR__ >= ((maj) << 16) + (min))
+#else
+#define __GLIBC_PREREQ(maj, min) (0)
+#endif
+#endif /* __GLIBC_PREREQ */
+#if defined(__e2k__) && !__GLIBC_PREREQ(2, 24)
+LIBMDBX_API int mdbx_e2k_memcmp_bug_workaround(const void *s1, const void *s2,
+ size_t n);
+LIBMDBX_API int mdbx_e2k_strcmp_bug_workaround(const char *s1, const char *s2);
+LIBMDBX_API int mdbx_e2k_strncmp_bug_workaround(const char *s1, const char *s2,
+ size_t n);
+LIBMDBX_API size_t mdbx_e2k_strlen_bug_workaround(const char *s);
+LIBMDBX_API size_t mdbx_e2k_strnlen_bug_workaround(const char *s,
+ size_t maxlen);
+#include
+#include
+#undef memcmp
+#define memcmp mdbx_e2k_memcmp_bug_workaround
+#undef bcmp
+#define bcmp mdbx_e2k_memcmp_bug_workaround
+#undef strcmp
+#define strcmp mdbx_e2k_strcmp_bug_workaround
+#undef strncmp
+#define strncmp mdbx_e2k_strncmp_bug_workaround
+#undef strlen
+#define strlen mdbx_e2k_strlen_bug_workaround
+#undef strnlen
+#define strnlen mdbx_e2k_strnlen_bug_workaround
+
+#endif /* Elbrus's memcmp() bug. */
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* LIBMDBX_H */
diff --git a/contrib/db/libmdbx/packages/rpm/CMakeLists.txt b/contrib/db/libmdbx/packages/rpm/CMakeLists.txt
new file mode 100644
index 00000000..5949e9f0
--- /dev/null
+++ b/contrib/db/libmdbx/packages/rpm/CMakeLists.txt
@@ -0,0 +1,184 @@
+cmake_minimum_required(VERSION 2.8.7)
+set(TARGET mdbx)
+project(${TARGET})
+
+set(MDBX_VERSION_MAJOR 0)
+set(MDBX_VERSION_MINOR 3)
+set(MDBX_VERSION_RELEASE 1)
+set(MDBX_VERSION_REVISION 0)
+
+set(MDBX_VERSION_STRING ${MDBX_VERSION_MAJOR}.${MDBX_VERSION_MINOR}.${MDBX_VERSION_RELEASE})
+
+enable_language(C)
+enable_language(CXX)
+
+set(CMAKE_CXX_STANDARD 11)
+set(CMAKE_CXX_STANDARD_REQUIRED on)
+
+add_definitions(-DNDEBUG=1 -DMDBX_DEBUG=0 -DLIBMDBX_EXPORTS=1 -D_GNU_SOURCE=1)
+
+find_package(Threads REQUIRED)
+
+get_directory_property(hasParent PARENT_DIRECTORY)
+if(hasParent)
+ set(STANDALONE_BUILD 0)
+else()
+ set(STANDALONE_BUILD 1)
+ enable_testing()
+
+ if (CMAKE_C_COMPILER_ID MATCHES GNU)
+ set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -O2")
+ set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -g3")
+ set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -Wall")
+ set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -Werror")
+ set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -Wextra")
+ set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -ffunction-sections")
+ set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -fPIC")
+ set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -fvisibility=hidden")
+ set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -std=gnu11")
+ set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -pthread")
+ endif()
+
+ if (CMAKE_CXX_COMPILER_ID MATCHES GNU)
+ set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -W")
+ set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Wall")
+ set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Werror")
+ set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Wpointer-arith")
+ set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Wno-sign-compare")
+ set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Wformat-security")
+ set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Woverloaded-virtual")
+ set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Wwrite-strings")
+ set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -fmax-errors=20")
+ set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -fvisibility=hidden")
+ set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Wno-unused-parameter -Wunused-function -Wunused-variable -Wunused-value -Wmissing-declarations")
+ set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Wno-missing-field-initializers")
+ set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Wcast-qual")
+ set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -ggdb")
+ set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -fno-omit-frame-pointer")
+ set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Wno-strict-aliasing")
+ set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -finline-functions-called-once")
+ set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Wno-packed-bitfield-compat")
+
+ set(CMAKE_CXX_FLAGS_DEBUG "-O0 -g3")
+ set(CMAKE_CXX_FLAGS_RELWITHDEBINFO "-O3 -g3")
+ endif()
+
+ if (COVERAGE)
+ if (NOT "${CMAKE_BUILD_TYPE}" STREQUAL "Debug")
+ message(FATAL_ERROR "Coverage requires -DCMAKE_BUILD_TYPE=Debug Current value=${CMAKE_BUILD_TYPE}")
+ endif()
+
+ message(STATUS "Setting coverage compiler flags")
+ set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -g -ggdb3 -O0 --coverage -fprofile-arcs -ftest-coverage")
+ set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -g -ggdb3 -O0 --coverage -fprofile-arcs -ftest-coverage")
+ add_definitions(-DCOVERAGE_TEST)
+ endif()
+
+ if (NOT TRAVIS)
+ set(CMAKE_CXX_FLAGS_DEBUG "${CMAKE_CXX_FLAGS_DEBUG} -fsanitize=address -fsanitize=leak -fstack-protector-strong -static-libasan")
+ endif()
+endif()
+
+set(${TARGET}_SRC
+ mdbx.h
+ src/bits.h
+ src/defs.h
+ src/lck-linux.c
+ src/mdbx.c
+ src/osal.c
+ src/osal.h
+ src/version.c
+ )
+
+add_library(${TARGET}_STATIC STATIC
+ ${${TARGET}_SRC}
+ )
+
+add_library(${TARGET} ALIAS ${TARGET}_STATIC)
+
+add_library(${TARGET}_SHARED SHARED
+ ${${TARGET}_SRC}
+ )
+
+set_target_properties(${TARGET}_SHARED PROPERTIES
+ VERSION ${MDBX_VERSION_STRING}
+ SOVERSION ${MDBX_VERSION_MAJOR}.${MDBX_VERSION_MINOR}
+ OUTPUT_NAME ${TARGET}
+ CLEAN_DIRECT_OUTPUT 1
+ )
+
+set_target_properties(${TARGET}_STATIC PROPERTIES
+ VERSION ${MDBX_VERSION_STRING}
+ SOVERSION ${MDBX_VERSION_MAJOR}.${MDBX_VERSION_MINOR}
+ OUTPUT_NAME ${TARGET}
+ CLEAN_DIRECT_OUTPUT 1
+ )
+
+target_include_directories(${TARGET}_STATIC PUBLIC
+ ${CMAKE_CURRENT_SOURCE_DIR})
+target_include_directories(${TARGET}_SHARED PUBLIC
+ ${CMAKE_CURRENT_SOURCE_DIR})
+
+target_link_libraries(${TARGET}_STATIC ${CMAKE_THREAD_LIBS_INIT})
+target_link_libraries(${TARGET}_SHARED ${CMAKE_THREAD_LIBS_INIT})
+if(UNIX AND NOT APPLE)
+ target_link_libraries(${TARGET}_STATIC rt)
+ target_link_libraries(${TARGET}_SHARED rt)
+endif()
+
+install(TARGETS ${TARGET}_STATIC DESTINATION ${CMAKE_INSTALL_PREFIX}/lib64 COMPONENT mdbx)
+install(TARGETS ${TARGET}_SHARED DESTINATION ${CMAKE_INSTALL_PREFIX}/lib64 COMPONENT mdbx)
+install(FILES mdbx.h DESTINATION ${CMAKE_INSTALL_PREFIX}/include COMPONENT mdbx-devel)
+
+add_subdirectory(src/tools)
+add_subdirectory(test)
+add_subdirectory(test/pcrf)
+add_subdirectory(tutorial)
+
+##############################################################################
+
+set(CPACK_GENERATOR "RPM")
+set(CPACK_RPM_COMPONENT_INSTALL ON)
+
+# Version
+if (NOT "$ENV{BUILD_NUMBER}" STREQUAL "")
+ set(CPACK_PACKAGE_RELEASE $ENV{BUILD_NUMBER})
+else()
+ if (NOT "$ENV{CI_PIPELINE_ID}" STREQUAL "")
+ set(CPACK_PACKAGE_RELEASE $ENV{CI_PIPELINE_ID})
+ else()
+ set(CPACK_PACKAGE_RELEASE 1)
+ endif()
+endif()
+set(CPACK_RPM_PACKAGE_RELEASE ${CPACK_PACKAGE_RELEASE})
+
+set(CPACK_PACKAGE_VERSION ${MDBX_VERSION_STRING})
+set(CPACK_PACKAGE_VERSION_FULL ${CPACK_PACKAGE_VERSION}-${CPACK_PACKAGE_RELEASE})
+
+set(CPACK_RPM_mdbx-devel_PACKAGE_REQUIRES "mdbx = ${CPACK_PACKAGE_VERSION}")
+
+set(CPACK_RPM_SPEC_INSTALL_POST "/bin/true")
+set(CPACK_RPM_mdbx_PACKAGE_NAME mdbx)
+set(CPACK_RPM_mdbx-devel_PACKAGE_NAME mdbx-devel)
+set(CPACK_PACKAGE_DESCRIPTION_SUMMARY "The revised and extended descendant of Symas LMDB")
+
+set(CPACK_PACKAGE_VENDOR "???")
+set(CPACK_PACKAGE_CONTACT "Vladimir Romanov")
+set(CPACK_PACKAGE_RELOCATABLE false)
+set(CPACK_RPM_PACKAGE_ARCHITECTURE "x86_64")
+set(CPACK_RPM_PACKAGE_REQUIRES "")
+set(CPACK_RPM_PACKAGE_GROUP "Applications/Database")
+
+set(CPACK_RPM_mdbx_FILE_NAME "${CPACK_RPM_mdbx_PACKAGE_NAME}-${CPACK_PACKAGE_VERSION_FULL}.${CPACK_RPM_PACKAGE_ARCHITECTURE}.rpm")
+set(CPACK_RPM_mdbx-devel_FILE_NAME "${CPACK_RPM_mdbx-devel_PACKAGE_NAME}-${CPACK_PACKAGE_VERSION_FULL}.${CPACK_RPM_PACKAGE_ARCHITECTURE}.rpm")
+
+set(CPACK_RPM_EXCLUDE_FROM_AUTO_FILELIST_ADDITION
+ /usr/local
+ /usr/local/bin
+ /usr/local/lib64
+ /usr/local/include
+ /usr/local/man
+ /usr/local/man/man1
+ )
+
+include(CPack)
diff --git a/contrib/db/libmdbx/packages/rpm/build.sh b/contrib/db/libmdbx/packages/rpm/build.sh
new file mode 100644
index 00000000..51708822
--- /dev/null
+++ b/contrib/db/libmdbx/packages/rpm/build.sh
@@ -0,0 +1,18 @@
+#!/bin/bash
+set -e
+CONFIG=$1
+
+if [[ -z "${CONFIG}" ]]; then
+ CONFIG=Debug
+fi
+if [[ -r /opt/rh/devtoolset-6/enable ]]; then
+ source /opt/rh/devtoolset-6/enable
+fi
+#rm -f -r build || true
+mkdir -p cmake-build-${CONFIG}
+pushd cmake-build-${CONFIG} &> /dev/null
+if [[ ! -r Makefile ]]; then
+ cmake .. -DCMAKE_BUILD_TYPE=${CONFIG}
+fi
+make -j8 || exit 1
+popd &> /dev/null
diff --git a/contrib/db/libmdbx/packages/rpm/package.sh b/contrib/db/libmdbx/packages/rpm/package.sh
new file mode 100644
index 00000000..d7f9ab29
--- /dev/null
+++ b/contrib/db/libmdbx/packages/rpm/package.sh
@@ -0,0 +1,25 @@
+#!/bin/bash
+set -e
+
+CONFIG=$1
+
+if [[ -z "${CONFIG}" ]]; then
+ CONFIG=Debug
+fi
+
+DIRNAME=`dirname ${BASH_SOURCE[0]}`
+DIRNAME=`readlink --canonicalize ${DIRNAME}`
+
+if [[ -r /opt/rh/devtoolset-6/enable ]]; then
+ source /opt/rh/devtoolset-6/enable
+fi
+
+mkdir -p cmake-build-${CONFIG}
+pushd cmake-build-${CONFIG} &> /dev/null
+if [[ ! -r Makefile ]]; then
+ cmake .. -DCMAKE_BUILD_TYPE=${CONFIG}
+fi
+rm -f *.rpm
+make -j8 package || exit 1
+rm -f *-Unspecified.rpm
+popd &> /dev/null
diff --git a/contrib/db/libmdbx/src/CMakeLists.txt b/contrib/db/libmdbx/src/CMakeLists.txt
new file mode 100644
index 00000000..04aead5f
--- /dev/null
+++ b/contrib/db/libmdbx/src/CMakeLists.txt
@@ -0,0 +1,225 @@
+##
+## Copyright 2019 Leonid Yuriev
+## and other libmdbx authors: please see AUTHORS file.
+## All rights reserved.
+##
+## Redistribution and use in source and binary forms, with or without
+## modification, are permitted only as authorized by the OpenLDAP
+## Public License.
+##
+## A copy of this license is available in the file LICENSE in the
+## top-level directory of the distribution or, alternatively, at
+## .
+##
+
+# Get version
+fetch_version(MDBX "${CMAKE_CURRENT_SOURCE_DIR}/../VERSION")
+message(STATUS "libmdbx version is ${MDBX_VERSION}")
+
+if(MDBX_ALLOY_MODE)
+ set(LIBMDBX_SOURCES alloy.c)
+else()
+ if(${CMAKE_SYSTEM_NAME} STREQUAL "Windows")
+ set(LIBMDBX_OSAL windows)
+ else()
+ set(LIBMDBX_OSAL posix)
+ endif()
+ set(LIBMDBX_SOURCES
+ elements/defs.h elements/internals.h elements/osal.h
+ elements/core.c elements/osal.c elements/lck-${LIBMDBX_OSAL}.c)
+endif()
+list(APPEND LIBMDBX_SOURCES ../mdbx.h
+ "${CMAKE_CURRENT_SOURCE_DIR}/elements/version.c"
+ "${CMAKE_CURRENT_SOURCE_DIR}/elements/config.h")
+
+if(MDBX_BUILD_SHARED_LIBRARY)
+ add_library(mdbx SHARED ${LIBMDBX_SOURCES})
+ target_compile_definitions(mdbx PRIVATE LIBMDBX_EXPORTS INTERFACE LIBMDBX_IMPORTS)
+ set(MDBX_LIBDEP_MODE PRIVATE)
+else()
+ add_library(mdbx STATIC ${LIBMDBX_SOURCES})
+ set(MDBX_LIBDEP_MODE PUBLIC)
+endif()
+
+if(CC_HAS_VISIBILITY AND (LTO_ENABLED OR INTERPROCEDURAL_OPTIMIZATION))
+ set_target_properties(mdbx PROPERTIES LINK_FLAGS "-fvisibility=hidden")
+endif()
+
+if(${CMAKE_SYSTEM_NAME} STREQUAL "Windows")
+ if(MSVC)
+ if(NOT MSVC_LIB_EXE)
+ # Find lib.exe
+ get_filename_component(CL_NAME ${CMAKE_C_COMPILER} NAME)
+ string(REPLACE cl.exe lib.exe MSVC_LIB_EXE ${CL_NAME})
+ find_program(MSVC_LIB_EXE ${MSVC_LIB_EXE})
+ endif()
+ if(MSVC_LIB_EXE)
+ message(STATUS "Found MSVC's lib tool: ${MSVC_LIB_EXE}")
+ set(MDBX_NTDLL_EXTRA_IMPLIB ${CMAKE_CURRENT_BINARY_DIR}/mdbx_ntdll_extra.lib)
+ add_custom_command(OUTPUT ${MDBX_NTDLL_EXTRA_IMPLIB}
+ COMMENT "Create extra-import-library for ntdll.dll"
+ MAIN_DEPENDENCY "${CMAKE_CURRENT_SOURCE_DIR}/elements/ntdll.def"
+ COMMAND ${MSVC_LIB_EXE} /def:"${CMAKE_CURRENT_SOURCE_DIR}/elements/ntdll.def" /out:"${MDBX_NTDLL_EXTRA_IMPLIB}" ${INITIAL_CMAKE_STATIC_LINKER_FLAGS})
+ else()
+ message(SEND_ERROR "MSVC's lib tool not found")
+ endif()
+ elseif(MINGW OR MINGW64)
+ if(NOT DLLTOOL)
+ # Find dlltool
+ get_filename_component(GCC_NAME ${CMAKE_C_COMPILER} NAME)
+ string(REPLACE gcc dlltool DLLTOOL_NAME ${GCC_NAME})
+ find_program(DLLTOOL NAMES ${DLLTOOL_NAME})
+ endif()
+ if(DLLTOOL)
+ message(STATUS "Found dlltool: ${DLLTOOL}")
+ set(MDBX_NTDLL_EXTRA_IMPLIB "${CMAKE_CURRENT_BINARY_DIR}/mdbx_ntdll_extra.a")
+ add_custom_command(OUTPUT ${MDBX_NTDLL_EXTRA_IMPLIB}
+ COMMENT "Create extra-import-library for ntdll.dll"
+ MAIN_DEPENDENCY "${CMAKE_CURRENT_SOURCE_DIR}/elements/ntdll.def"
+ COMMAND ${DLLTOOL} -d "${CMAKE_CURRENT_SOURCE_DIR}/elements/ntdll.def" -l "${MDBX_NTDLL_EXTRA_IMPLIB}")
+ else()
+ message(SEND_ERROR "dlltool not found")
+ endif()
+ endif()
+endif()
+
+target_link_libraries(mdbx ${MDBX_LIBDEP_MODE} ${CMAKE_THREAD_LIBS_INIT})
+if(${CMAKE_SYSTEM_NAME} STREQUAL "Windows")
+ target_link_libraries(mdbx ${MDBX_LIBDEP_MODE} ntdll.lib)
+ if(MDBX_NTDLL_EXTRA_IMPLIB)
+ # LY: Sometimes Cmake requires a nightmarish magic for simple things.
+ # 1) create a target out of the library compilation result
+ add_custom_target(ntdll_extra_target DEPENDS ${MDBX_NTDLL_EXTRA_IMPLIB})
+ # 2) create an library target out of the library compilation result
+ add_library(ntdll_extra STATIC IMPORTED GLOBAL)
+ add_dependencies(ntdll_extra ntdll_extra_target)
+ # 3) specify where the library is (and where to find the headers)
+ set_target_properties(ntdll_extra
+ PROPERTIES
+ IMPORTED_LOCATION ${MDBX_NTDLL_EXTRA_IMPLIB})
+ target_link_libraries(mdbx ${MDBX_LIBDEP_MODE} ntdll_extra)
+ endif()
+endif()
+
+set_target_properties(mdbx PROPERTIES
+ INTERPROCEDURAL_OPTIMIZATION $
+ C_STANDARD ${MDBX_C_STANDARD} C_STANDARD_REQUIRED ON
+ PUBLIC_HEADER "../mdbx.h")
+
+if(CC_HAS_FASTMATH)
+ target_compile_options(mdbx PRIVATE "-ffast-math")
+endif()
+if(BUILD_FOR_NATIVE_CPU AND CC_HAS_ARCH_NATIVE)
+ target_compile_options(mdbx PUBLIC "-march=native")
+endif()
+if(CC_HAS_VISIBILITY)
+ target_compile_options(mdbx PRIVATE "-fvisibility=hidden")
+endif()
+
+install(TARGETS mdbx
+ LIBRARY DESTINATION lib COMPONENT runtime
+ RUNTIME DESTINATION bin COMPONENT runtime
+ ARCHIVE DESTINATION lib/static COMPONENT devel
+ PUBLIC_HEADER DESTINATION include
+ INCLUDES DESTINATION include COMPONENT devel)
+
+################################################################################
+#
+# library build info (used in library version output)
+#
+set(MDBX_BUILD_FLAGS "")
+
+# append cmake's build-type flags and defines
+if(NOT CMAKE_CONFIGURATION_TYPES)
+ list(APPEND MDBX_BUILD_FLAGS ${CMAKE_C_FLAGS_${CMAKE_BUILD_TYPE_UPPERCASE}})
+ list(APPEND MDBX_BUILD_FLAGS ${CMAKE_C_DEFINES_${CMAKE_BUILD_TYPE_UPPERCASE}})
+endif()
+
+# append linker dll's options
+if(LIBMDBX_TYPE STREQUAL "SHARED")
+ list(APPEND MDBX_BUILD_FLAGS ${CMAKE_SHARED_LINKER_FLAGS})
+endif()
+
+# get definitions
+get_target_property(defs_list mdbx COMPILE_DEFINITIONS)
+if(defs_list)
+ list(APPEND MDBX_BUILD_FLAGS ${defs_list})
+endif()
+
+# get target compile options
+get_target_property(options_list mdbx COMPILE_OPTIONS)
+if(options_list)
+ list(APPEND MDBX_BUILD_FLAGS ${options_list})
+endif()
+
+list(REMOVE_DUPLICATES MDBX_BUILD_FLAGS)
+string(REPLACE ";" " " MDBX_BUILD_FLAGS "${MDBX_BUILD_FLAGS}")
+if(CMAKE_CONFIGURATION_TYPES)
+ # add dynamic part via per-configuration define
+ message(STATUS "MDBX Compile Flags: ${MDBX_BUILD_FLAGS} ")
+ add_definitions(-DMDBX_BUILD_FLAGS_CONFIG="$<$:${CMAKE_C_FLAGS_DEBUG} ${CMAKE_C_DEFINES_DEBUG}>$<$:${CMAKE_C_FLAGS_RELEASE} ${CMAKE_C_DEFINES_RELEASE}>$<$:${CMAKE_C_FLAGS_RELWITHDEBINFO} ${CMAKE_C_DEFINES_RELWITHDEBINFO}>$<$:${CMAKE_C_FLAGS_MINSIZEREL} ${CMAKE_C_DEFINES_MINSIZEREL}>")
+else()
+ message(STATUS "MDBX Compile Flags: ${MDBX_BUILD_FLAGS}")
+endif()
+
+# get compiler info
+execute_process(COMMAND sh -c "${CMAKE_C_COMPILER} --version | head -1"
+ OUTPUT_VARIABLE MDBX_BUILD_COMPILER
+ OUTPUT_STRIP_TRAILING_WHITESPACE
+ ERROR_QUIET
+ RESULT_VARIABLE rc)
+if(rc OR NOT MDBX_BUILD_COMPILER)
+ string(STRIP "${CMAKE_C_COMPILER_ID}-${CMAKE_C_COMPILER_VERSION}" MDBX_BUILD_COMPILER)
+endif()
+
+# make a build-target triplet
+if(CMAKE_C_COMPILER_TARGET)
+ set(MDBX_BUILD_TARGET "${CMAKE_C_COMPILER_TARGET}")
+elseif(CMAKE_C_PLATFORM_ID AND NOT CMAKE_C_PLATFORM_ID STREQUAL CMAKE_SYSTEM_NAME)
+ string(STRIP "${CMAKE_C_PLATFORM_ID}-${CMAKE_SYSTEM_NAME}" MDBX_BUILD_TARGET)
+elseif(CMAKE_LIBRARY_ARCHITECTURE)
+ string(STRIP "${CMAKE_LIBRARY_ARCHITECTURE}-${CMAKE_SYSTEM_NAME}" MDBX_BUILD_TARGET)
+elseif(CMAKE_GENERATOR_PLATFORM AND NOT CMAKE_C_PLATFORM_ID STREQUAL CMAKE_SYSTEM_NAME)
+ string(STRIP "${CMAKE_GENERATOR_PLATFORM}-${CMAKE_SYSTEM_NAME}" MDBX_BUILD_TARGET)
+elseif(CMAKE_SYSTEM_ARCH)
+ string(STRIP "${CMAKE_SYSTEM_ARCH}-${CMAKE_SYSTEM_NAME}" MDBX_BUILD_TARGET)
+else()
+ string(STRIP "${CMAKE_SYSTEM_PROCESSOR}-${CMAKE_SYSTEM_NAME}" MDBX_BUILD_TARGET)
+endif()
+if(CMAKE_CONFIGURATION_TYPES)
+ add_definitions(-DMDBX_BUILD_CONFIG="$")
+else()
+ set(MDBX_BUILD_CONFIG ${CMAKE_BUILD_TYPE})
+endif()
+
+# options
+string(TIMESTAMP MDBX_BUILD_TIMESTAMP UTC)
+set(options VERSION C_COMPILER CXX_COMPILER)
+foreach(item IN LISTS options)
+ if(DEFINED ${item})
+ set(value "${${item}}")
+ elseif(DEFINED MDBX_${item})
+ set(item MDBX_${item})
+ set(value "${${item}}")
+ elseif(DEFINED CMAKE_${item})
+ set(item CMAKE_${item})
+ set(value "${${item}}")
+ else()
+ set(value "undefined")
+ endif()
+ message(STATUS "${item}: ${value}")
+endforeach(item)
+
+# generate version and config files
+configure_file("${CMAKE_CURRENT_SOURCE_DIR}/elements/version.c.in"
+ "${CMAKE_CURRENT_SOURCE_DIR}/elements/version.c" ESCAPE_QUOTES)
+
+file(SHA256 "${CMAKE_CURRENT_SOURCE_DIR}/elements/version.c" MDBX_SOURCERY_DIGEST)
+string(MAKE_C_IDENTIFIER "${MDBX_GIT_DESCRIBE}" MDBX_SOURCERY_SUFFIX)
+set(MDBX_BUILD_SOURCERY "${MDBX_SOURCERY_DIGEST}_${MDBX_SOURCERY_SUFFIX}")
+
+configure_file("${CMAKE_CURRENT_SOURCE_DIR}/elements/config.h.in"
+ "${CMAKE_CURRENT_SOURCE_DIR}/elements/config.h" ESCAPE_QUOTES)
+add_definitions(-DMDBX_CONFIG_H="config.h")
+
+add_subdirectory(tools)
diff --git a/contrib/db/libmdbx/src/alloy.c b/contrib/db/libmdbx/src/alloy.c
new file mode 100644
index 00000000..98f3aac3
--- /dev/null
+++ b/contrib/db/libmdbx/src/alloy.c
@@ -0,0 +1,26 @@
+/*
+ * Copyright 2015-2019 Leonid Yuriev
+ * and other libmdbx authors: please see AUTHORS file.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted only as authorized by the OpenLDAP
+ * Public License.
+ *
+ * A copy of this license is available in the file LICENSE in the
+ * top-level directory of the distribution or, alternatively, at
+ * . */
+
+/* Amalgamated build */
+#define MDBX_ALLOY 1
+#include "elements/internals.h" /* must be included fisrt */
+
+#include "elements/core.c"
+#include "elements/osal.c"
+#include "elements/version.c"
+
+#if defined(_WIN32) || defined(_WIN64)
+#include "elements/lck-windows.c"
+#else
+#include "elements/lck-posix.c"
+#endif
diff --git a/contrib/db/libmdbx/src/elements/config.h.in b/contrib/db/libmdbx/src/elements/config.h.in
new file mode 100644
index 00000000..44ae1507
--- /dev/null
+++ b/contrib/db/libmdbx/src/elements/config.h.in
@@ -0,0 +1,56 @@
+/* This is CMake-template for libmdbx's config.h
+ ******************************************************************************/
+
+/* *INDENT-OFF* */
+/* clang-format off */
+
+#cmakedefine HAVE_VALGRIND_MEMCHECK_H
+#cmakedefine HAS_RELAXED_CONSTEXPR
+
+#cmakedefine LTO_ENABLED
+#cmakedefine MDBX_USE_VALGRIND
+#cmakedefine ENABLE_GPROF
+#cmakedefine ENABLE_GCOV
+#cmakedefine ENABLE_ASAN
+
+/* Common */
+#cmakedefine01 MDBX_TXN_CHECKPID
+#cmakedefine01 MDBX_TXN_CHECKOWNER
+#cmakedefine01 MDBX_BUILD_SHARED_LIBRARY
+
+/* Windows */
+#cmakedefine01 MDBX_CONFIG_MANUAL_TLS_CALLBACK
+#cmakedefine01 MDBX_AVOID_CRT
+
+/* MacOS */
+#cmakedefine01 MDBX_OSX_SPEED_INSTEADOF_DURABILITY
+
+/* POSIX */
+#cmakedefine01 MDBX_USE_ROBUST
+#cmakedefine01 MDBX_USE_OFDLOCKS
+#cmakedefine01 MDBX_DISABLE_GNU_SOURCE
+
+/* Simulate "AUTO" values of tristate options */
+#cmakedefine MDBX_TXN_CHECKPID_AUTO
+#ifdef MDBX_TXN_CHECKPID_AUTO
+#undef MDBX_TXN_CHECKPID
+#endif
+#cmakedefine MDBX_USE_ROBUST_AUTO
+#ifdef MDBX_USE_ROBUST_AUTO
+#undef MDBX_USE_ROBUST
+#endif
+#cmakedefine MDBX_USE_OFDLOCKS_AUTO
+#ifdef MDBX_USE_OFDLOCKS_AUTO
+#undef MDBX_USE_OFDLOCKS
+#endif
+
+/* Build Info */
+#cmakedefine MDBX_BUILD_TIMESTAMP "@MDBX_BUILD_TIMESTAMP@"
+#cmakedefine MDBX_BUILD_TARGET "@MDBX_BUILD_TARGET@"
+#cmakedefine MDBX_BUILD_CONFIG "@MDBX_BUILD_CONFIG@"
+#cmakedefine MDBX_BUILD_COMPILER "@MDBX_BUILD_COMPILER@"
+#cmakedefine MDBX_BUILD_FLAGS "@MDBX_BUILD_FLAGS@"
+#cmakedefine MDBX_BUILD_SOURCERY @MDBX_BUILD_SOURCERY@
+
+/* *INDENT-ON* */
+/* clang-format on */
diff --git a/contrib/db/libmdbx/src/elements/core.c b/contrib/db/libmdbx/src/elements/core.c
new file mode 100644
index 00000000..c64259c8
--- /dev/null
+++ b/contrib/db/libmdbx/src/elements/core.c
@@ -0,0 +1,16709 @@
+/*
+ * Copyright 2015-2019 Leonid Yuriev
+ * and other libmdbx authors: please see AUTHORS file.
+ * All rights reserved.
+ *
+ * This code is derived from "LMDB engine" written by
+ * Howard Chu (Symas Corporation), which itself derived from btree.c
+ * written by Martin Hedenfalk.
+ *
+ * ---
+ *
+ * Portions Copyright 2011-2015 Howard Chu, Symas Corp. All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted only as authorized by the OpenLDAP
+ * Public License.
+ *
+ * A copy of this license is available in the file LICENSE in the
+ * top-level directory of the distribution or, alternatively, at
+ * .
+ *
+ * ---
+ *
+ * Portions Copyright (c) 2009, 2010 Martin Hedenfalk
+ *
+ * Permission to use, copy, modify, and distribute this software for any
+ * purpose with or without fee is hereby granted, provided that the above
+ * copyright notice and this permission notice appear in all copies.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+ * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+ * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+ * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+ * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. */
+
+#include "internals.h"
+
+/*------------------------------------------------------------------------------
+ * Internal inlines */
+
+static __pure_function __inline bool is_powerof2(size_t x) {
+ return (x & (x - 1)) == 0;
+}
+
+static __pure_function __inline size_t roundup_powerof2(size_t value,
+ size_t granularity) {
+ assert(is_powerof2(granularity));
+ return (value + granularity - 1) & ~(granularity - 1);
+}
+
+static __pure_function unsigned log2n(size_t value) {
+ assert(value > 0 && value < INT32_MAX && is_powerof2(value));
+ assert((value & -(int32_t)value) == value);
+#if __GNUC_PREREQ(4, 1) || __has_builtin(__builtin_ctzl)
+ return __builtin_ctzl(value);
+#elif defined(_MSC_VER)
+ unsigned long index;
+ _BitScanForward(&index, (unsigned long)value);
+ return index;
+#else
+ static const uint8_t debruijn_ctz32[32] = {
+ 0, 1, 28, 2, 29, 14, 24, 3, 30, 22, 20, 15, 25, 17, 4, 8,
+ 31, 27, 13, 23, 21, 19, 16, 7, 26, 12, 18, 6, 11, 5, 10, 9};
+ return debruijn_ctz32[(uint32_t)(value * 0x077CB531u) >> 27];
+#endif
+}
+
+/*------------------------------------------------------------------------------
+ * Unaligned access */
+
+static __pure_function __maybe_unused __inline unsigned
+field_alignment(unsigned alignment_baseline, size_t field_offset) {
+ unsigned merge = alignment_baseline | (unsigned)field_offset;
+ return merge & -(int)merge;
+}
+
+/* read-thunk for UB-sanitizer */
+static __pure_function __inline uint8_t peek_u8(const uint8_t *ptr) {
+ return *ptr;
+}
+
+/* write-thunk for UB-sanitizer */
+static __inline void poke_u8(uint8_t *ptr, const uint8_t v) { *ptr = v; }
+
+static __pure_function __inline uint16_t
+unaligned_peek_u16(const unsigned expected_alignment, const void *ptr) {
+ assert((uintptr_t)ptr % expected_alignment == 0);
+ if (MDBX_UNALIGNED_OK || (expected_alignment % sizeof(uint16_t)) == 0)
+ return *(const uint16_t *)ptr;
+ else {
+ uint16_t v;
+ memcpy(&v, ptr, sizeof(v));
+ return v;
+ }
+}
+
+static __inline void unaligned_poke_u16(const unsigned expected_alignment,
+ void *ptr, const uint16_t v) {
+ assert((uintptr_t)ptr % expected_alignment == 0);
+ if (MDBX_UNALIGNED_OK || (expected_alignment % sizeof(v)) == 0)
+ *(uint16_t *)ptr = v;
+ else
+ memcpy(ptr, &v, sizeof(v));
+}
+
+static __pure_function __inline uint32_t
+unaligned_peek_u32(const unsigned expected_alignment, const void *ptr) {
+ assert((uintptr_t)ptr % expected_alignment == 0);
+ if (MDBX_UNALIGNED_OK || (expected_alignment % sizeof(uint32_t)) == 0)
+ return *(const uint32_t *)ptr;
+ else if ((expected_alignment % sizeof(uint16_t)) == 0) {
+ const uint16_t lo =
+ ((const uint16_t *)ptr)[__BYTE_ORDER__ != __ORDER_LITTLE_ENDIAN__];
+ const uint16_t hi =
+ ((const uint16_t *)ptr)[__BYTE_ORDER__ == __ORDER_LITTLE_ENDIAN__];
+ return lo | (uint32_t)hi << 16;
+ } else {
+ uint32_t v;
+ memcpy(&v, ptr, sizeof(v));
+ return v;
+ }
+}
+
+static __inline void unaligned_poke_u32(const unsigned expected_alignment,
+ void *ptr, const uint32_t v) {
+ assert((uintptr_t)ptr % expected_alignment == 0);
+ if (MDBX_UNALIGNED_OK || (expected_alignment % sizeof(v)) == 0)
+ *(uint32_t *)ptr = v;
+ else if ((expected_alignment % sizeof(uint16_t)) == 0) {
+ ((uint16_t *)ptr)[__BYTE_ORDER__ != __ORDER_LITTLE_ENDIAN__] = (uint16_t)v;
+ ((uint16_t *)ptr)[__BYTE_ORDER__ == __ORDER_LITTLE_ENDIAN__] =
+ (uint16_t)(v >> 16);
+ } else
+ memcpy(ptr, &v, sizeof(v));
+}
+
+static __pure_function __inline uint64_t
+unaligned_peek_u64(const unsigned expected_alignment, const void *ptr) {
+ assert((uintptr_t)ptr % expected_alignment == 0);
+ if (MDBX_UNALIGNED_OK || (expected_alignment % sizeof(uint64_t)) == 0)
+ return *(const uint64_t *)ptr;
+ else if ((expected_alignment % sizeof(uint32_t)) == 0) {
+ const uint32_t lo =
+ ((const uint32_t *)ptr)[__BYTE_ORDER__ != __ORDER_LITTLE_ENDIAN__];
+ const uint32_t hi =
+ ((const uint32_t *)ptr)[__BYTE_ORDER__ == __ORDER_LITTLE_ENDIAN__];
+ return lo | (uint64_t)hi << 32;
+ } else {
+ uint64_t v;
+ memcpy(&v, ptr, sizeof(v));
+ return v;
+ }
+}
+
+static __inline void unaligned_poke_u64(const unsigned expected_alignment,
+ void *ptr, const uint64_t v) {
+ assert((uintptr_t)ptr % expected_alignment == 0);
+ if (MDBX_UNALIGNED_OK || (expected_alignment % sizeof(v)) == 0)
+ *(uint64_t *)ptr = v;
+ else if ((expected_alignment % sizeof(uint32_t)) == 0) {
+ ((uint32_t *)ptr)[__BYTE_ORDER__ != __ORDER_LITTLE_ENDIAN__] = (uint32_t)v;
+ ((uint32_t *)ptr)[__BYTE_ORDER__ == __ORDER_LITTLE_ENDIAN__] =
+ (uint32_t)(v >> 32);
+ } else
+ memcpy(ptr, &v, sizeof(v));
+}
+
+#define UNALIGNED_PEEK_8(ptr, struct, field) \
+ peek_u8((const uint8_t *)(ptr) + offsetof(struct, field))
+#define UNALIGNED_POKE_8(ptr, struct, field, value) \
+ poke_u8((uint8_t *)(ptr) + offsetof(struct, field), value)
+
+#define UNALIGNED_PEEK_16(ptr, struct, field) \
+ unaligned_peek_u16(1, (const char *)(ptr) + offsetof(struct, field))
+#define UNALIGNED_POKE_16(ptr, struct, field, value) \
+ unaligned_poke_u16(1, (char *)(ptr) + offsetof(struct, field), value)
+
+#define UNALIGNED_PEEK_32(ptr, struct, field) \
+ unaligned_peek_u32(1, (const char *)(ptr) + offsetof(struct, field))
+#define UNALIGNED_POKE_32(ptr, struct, field, value) \
+ unaligned_poke_u32(1, (char *)(ptr) + offsetof(struct, field), value)
+
+#define UNALIGNED_PEEK_64(ptr, struct, field) \
+ unaligned_peek_u64(1, (const char *)(ptr) + offsetof(struct, field))
+#define UNALIGNED_POKE_64(ptr, struct, field, value) \
+ unaligned_poke_u64(1, (char *)(ptr) + offsetof(struct, field), value)
+
+/* Get the page number pointed to by a branch node */
+static __pure_function __inline pgno_t node_pgno(const MDBX_node *node) {
+ pgno_t pgno = UNALIGNED_PEEK_32(node, MDBX_node, mn_pgno32);
+ if (sizeof(pgno) > 4)
+ pgno |= ((uint64_t)UNALIGNED_PEEK_8(node, MDBX_node, mn_extra)) << 32;
+ return pgno;
+}
+
+/* Set the page number in a branch node */
+static __inline void node_set_pgno(MDBX_node *node, pgno_t pgno) {
+ assert(pgno >= MIN_PAGENO && pgno <= MAX_PAGENO);
+
+ UNALIGNED_POKE_32(node, MDBX_node, mn_pgno32, (uint32_t)pgno);
+ if (sizeof(pgno) > 4)
+ UNALIGNED_POKE_8(node, MDBX_node, mn_extra,
+ (uint8_t)((uint64_t)pgno >> 32));
+}
+
+/* Get the size of the data in a leaf node */
+static __pure_function __inline size_t node_ds(const MDBX_node *node) {
+ return UNALIGNED_PEEK_32(node, MDBX_node, mn_dsize);
+}
+
+/* Set the size of the data for a leaf node */
+static __inline void node_set_ds(MDBX_node *node, size_t size) {
+ assert(size < INT_MAX);
+ UNALIGNED_POKE_32(node, MDBX_node, mn_dsize, (uint32_t)size);
+}
+
+/* The size of a key in a node */
+static __pure_function __inline size_t node_ks(const MDBX_node *node) {
+ return UNALIGNED_PEEK_16(node, MDBX_node, mn_ksize);
+}
+
+/* Set the size of the key for a leaf node */
+static __inline void node_set_ks(MDBX_node *node, size_t size) {
+ assert(size < INT16_MAX);
+ UNALIGNED_POKE_16(node, MDBX_node, mn_ksize, (uint16_t)size);
+}
+
+static __pure_function __inline uint8_t node_flags(const MDBX_node *node) {
+ return UNALIGNED_PEEK_8(node, MDBX_node, mn_flags);
+}
+
+static __inline void node_set_flags(MDBX_node *node, uint8_t flags) {
+ UNALIGNED_POKE_8(node, MDBX_node, mn_flags, flags);
+}
+
+/* Size of the node header, excluding dynamic data at the end */
+#define NODESIZE offsetof(MDBX_node, mn_data)
+
+/* Address of the key for the node */
+static __pure_function __inline void *node_key(const MDBX_node *node) {
+ return (char *)node + NODESIZE;
+}
+
+/* Address of the data for a node */
+static __pure_function __inline void *node_data(const MDBX_node *node) {
+ return (char *)node_key(node) + node_ks(node);
+}
+
+/* Size of a node in a leaf page with a given key and data.
+ * This is node header plus key plus data size. */
+static __pure_function __inline size_t node_size(const MDBX_val *key,
+ const MDBX_val *value) {
+ return NODESIZE +
+ EVEN((key ? key->iov_len : 0) + (value ? value->iov_len : 0));
+}
+
+static __pure_function __inline pgno_t peek_pgno(const void *ptr) {
+ if (sizeof(pgno_t) == sizeof(uint32_t))
+ return (pgno_t)unaligned_peek_u32(1, ptr);
+ else if (sizeof(pgno_t) == sizeof(uint64_t))
+ return (pgno_t)unaligned_peek_u64(1, ptr);
+ else {
+ pgno_t pgno;
+ memcpy(&pgno, ptr, sizeof(pgno));
+ return pgno;
+ }
+}
+
+static __inline void poke_pgno(void *ptr, const pgno_t pgno) {
+ if (sizeof(pgno) == sizeof(uint32_t))
+ unaligned_poke_u32(1, ptr, pgno);
+ else if (sizeof(pgno) == sizeof(uint64_t))
+ unaligned_poke_u64(1, ptr, pgno);
+ else
+ memcpy(ptr, &pgno, sizeof(pgno));
+}
+
+static __pure_function __inline pgno_t
+node_largedata_pgno(const MDBX_node *node) {
+ assert(node_flags(node) & F_BIGDATA);
+ return peek_pgno(node_data(node));
+}
+
+/* Calculate the size of a leaf node.
+ *
+ * The size depends on the environment's page size; if a data item
+ * is too large it will be put onto an overflow page and the node
+ * size will only include the key and not the data. Sizes are always
+ * rounded up to an even number of bytes, to guarantee 2-byte alignment
+ * of the MDBX_node headers.
+ *
+ * [in] env The environment handle.
+ * [in] key The key for the node.
+ * [in] data The data for the node.
+ *
+ * Returns The number of bytes needed to store the node. */
+static __pure_function __inline size_t
+leaf_size(const MDBX_env *env, const MDBX_val *key, const MDBX_val *data) {
+ size_t node_bytes = node_size(key, data);
+ if (node_bytes > env->me_nodemax) {
+ /* put on overflow page */
+ node_bytes = node_size(key, nullptr) + sizeof(pgno_t);
+ }
+
+ return node_bytes + sizeof(indx_t);
+}
+
+/* Calculate the size of a branch node.
+ *
+ * The size should depend on the environment's page size but since
+ * we currently don't support spilling large keys onto overflow
+ * pages, it's simply the size of the MDBX_node header plus the
+ * size of the key. Sizes are always rounded up to an even number
+ * of bytes, to guarantee 2-byte alignment of the MDBX_node headers.
+ *
+ * [in] env The environment handle.
+ * [in] key The key for the node.
+ *
+ * Returns The number of bytes needed to store the node. */
+static __pure_function __inline size_t branch_size(const MDBX_env *env,
+ const MDBX_val *key) {
+ /* Size of a node in a branch page with a given key.
+ * This is just the node header plus the key, there is no data. */
+ size_t node_bytes = node_size(key, nullptr);
+ if (unlikely(node_bytes > env->me_nodemax)) {
+ /* put on overflow page */
+ /* not implemented */
+ mdbx_assert_fail(env, "INDXSIZE(key) <= env->me_nodemax", __func__,
+ __LINE__);
+ node_bytes = node_size(key, nullptr) + sizeof(pgno_t);
+ }
+
+ return node_bytes + sizeof(indx_t);
+}
+
+/*----------------------------------------------------------------------------*/
+
+static __pure_function __inline size_t pgno2bytes(const MDBX_env *env,
+ pgno_t pgno) {
+ mdbx_assert(env, (1u << env->me_psize2log) == env->me_psize);
+ return ((size_t)pgno) << env->me_psize2log;
+}
+
+static __pure_function __inline MDBX_page *pgno2page(const MDBX_env *env,
+ pgno_t pgno) {
+ return (MDBX_page *)(env->me_map + pgno2bytes(env, pgno));
+}
+
+static __pure_function __inline pgno_t bytes2pgno(const MDBX_env *env,
+ size_t bytes) {
+ mdbx_assert(env, (env->me_psize >> env->me_psize2log) == 1);
+ return (pgno_t)(bytes >> env->me_psize2log);
+}
+
+static __pure_function __inline size_t pgno_align2os_bytes(const MDBX_env *env,
+ pgno_t pgno) {
+ return roundup_powerof2(pgno2bytes(env, pgno), env->me_os_psize);
+}
+
+static __pure_function __inline pgno_t pgno_align2os_pgno(const MDBX_env *env,
+ pgno_t pgno) {
+ return bytes2pgno(env, pgno_align2os_bytes(env, pgno));
+}
+
+static __pure_function __inline size_t bytes_align2os_bytes(const MDBX_env *env,
+ size_t bytes) {
+ return roundup_powerof2(roundup_powerof2(bytes, env->me_psize),
+ env->me_os_psize);
+}
+
+/* Address of first usable data byte in a page, after the header */
+static __pure_function __inline void *page_data(const MDBX_page *mp) {
+ return (char *)mp + PAGEHDRSZ;
+}
+
+static __pure_function __inline const MDBX_page *data_page(const void *data) {
+ return container_of(data, MDBX_page, mp_ptrs);
+}
+
+static __pure_function __inline MDBX_meta *page_meta(MDBX_page *mp) {
+ return (MDBX_meta *)page_data(mp);
+}
+
+/* Number of nodes on a page */
+static __pure_function __inline unsigned page_numkeys(const MDBX_page *mp) {
+ return mp->mp_lower >> 1;
+}
+
+/* The amount of space remaining in the page */
+static __pure_function __inline unsigned page_room(const MDBX_page *mp) {
+ return mp->mp_upper - mp->mp_lower;
+}
+
+static __pure_function __inline unsigned page_space(const MDBX_env *env) {
+ STATIC_ASSERT(PAGEHDRSZ % 2 == 0);
+ return env->me_psize - PAGEHDRSZ;
+}
+
+static __pure_function __inline unsigned page_used(const MDBX_env *env,
+ const MDBX_page *mp) {
+ return page_space(env) - page_room(mp);
+}
+
+/* The percentage of space used in the page, in a percents. */
+static __pure_function __maybe_unused __inline double
+page_fill(const MDBX_env *env, const MDBX_page *mp) {
+ return page_used(env, mp) * 100.0 / page_space(env);
+}
+
+static __pure_function __inline bool
+page_fill_enough(const MDBX_page *mp, unsigned spaceleft_threshold,
+ unsigned minkeys_threshold) {
+ return page_room(mp) < spaceleft_threshold &&
+ page_numkeys(mp) >= minkeys_threshold;
+}
+
+/* The number of overflow pages needed to store the given size. */
+static __pure_function __inline pgno_t number_of_ovpages(const MDBX_env *env,
+ size_t bytes) {
+ return bytes2pgno(env, PAGEHDRSZ - 1 + bytes) + 1;
+}
+
+/* Address of node i in page p */
+static __pure_function __inline MDBX_node *page_node(const MDBX_page *mp,
+ unsigned i) {
+ assert((mp->mp_flags & (P_LEAF2 | P_OVERFLOW | P_META)) == 0);
+ assert(page_numkeys(mp) > (unsigned)(i));
+ assert(mp->mp_ptrs[i] % 2 == 0);
+ return (MDBX_node *)((char *)mp + mp->mp_ptrs[i] + PAGEHDRSZ);
+}
+
+/* The address of a key in a LEAF2 page.
+ * LEAF2 pages are used for MDBX_DUPFIXED sorted-duplicate sub-DBs.
+ * There are no node headers, keys are stored contiguously. */
+static __pure_function __inline void *
+page_leaf2key(const MDBX_page *mp, unsigned i, size_t keysize) {
+ assert(mp->mp_leaf2_ksize == keysize);
+ (void)keysize;
+ return (char *)mp + PAGEHDRSZ + (i * mp->mp_leaf2_ksize);
+}
+
+/* Set the node's key into keyptr. */
+static __inline void get_key(const MDBX_node *node, MDBX_val *keyptr) {
+ keyptr->iov_len = node_ks(node);
+ keyptr->iov_base = node_key(node);
+}
+
+/* Set the node's key into keyptr, if requested. */
+static __inline void get_key_optional(const MDBX_node *node,
+ MDBX_val *keyptr /* __may_null */) {
+ if (keyptr)
+ get_key(node, keyptr);
+}
+
+/*------------------------------------------------------------------------------
+ * LY: temporary workaround for Elbrus's memcmp() bug. */
+
+#if defined(__e2k__) && !__GLIBC_PREREQ(2, 24)
+int __hot mdbx_e2k_memcmp_bug_workaround(const void *s1, const void *s2,
+ size_t n) {
+ if (unlikely(n > 42
+ /* LY: align followed access if reasonable possible */
+ && (((uintptr_t)s1) & 7) != 0 &&
+ (((uintptr_t)s1) & 7) == (((uintptr_t)s2) & 7))) {
+ if (((uintptr_t)s1) & 1) {
+ const int diff = *(uint8_t *)s1 - *(uint8_t *)s2;
+ if (diff)
+ return diff;
+ s1 = (char *)s1 + 1;
+ s2 = (char *)s2 + 1;
+ n -= 1;
+ }
+
+ if (((uintptr_t)s1) & 2) {
+ const uint16_t a = *(uint16_t *)s1;
+ const uint16_t b = *(uint16_t *)s2;
+ if (likely(a != b))
+ return (__builtin_bswap16(a) > __builtin_bswap16(b)) ? 1 : -1;
+ s1 = (char *)s1 + 2;
+ s2 = (char *)s2 + 2;
+ n -= 2;
+ }
+
+ if (((uintptr_t)s1) & 4) {
+ const uint32_t a = *(uint32_t *)s1;
+ const uint32_t b = *(uint32_t *)s2;
+ if (likely(a != b))
+ return (__builtin_bswap32(a) > __builtin_bswap32(b)) ? 1 : -1;
+ s1 = (char *)s1 + 4;
+ s2 = (char *)s2 + 4;
+ n -= 4;
+ }
+ }
+
+ while (n >= 8) {
+ const uint64_t a = *(uint64_t *)s1;
+ const uint64_t b = *(uint64_t *)s2;
+ if (likely(a != b))
+ return (__builtin_bswap64(a) > __builtin_bswap64(b)) ? 1 : -1;
+ s1 = (char *)s1 + 8;
+ s2 = (char *)s2 + 8;
+ n -= 8;
+ }
+
+ if (n & 4) {
+ const uint32_t a = *(uint32_t *)s1;
+ const uint32_t b = *(uint32_t *)s2;
+ if (likely(a != b))
+ return (__builtin_bswap32(a) > __builtin_bswap32(b)) ? 1 : -1;
+ s1 = (char *)s1 + 4;
+ s2 = (char *)s2 + 4;
+ }
+
+ if (n & 2) {
+ const uint16_t a = *(uint16_t *)s1;
+ const uint16_t b = *(uint16_t *)s2;
+ if (likely(a != b))
+ return (__builtin_bswap16(a) > __builtin_bswap16(b)) ? 1 : -1;
+ s1 = (char *)s1 + 2;
+ s2 = (char *)s2 + 2;
+ }
+
+ return (n & 1) ? *(uint8_t *)s1 - *(uint8_t *)s2 : 0;
+}
+
+int __hot mdbx_e2k_strcmp_bug_workaround(const char *s1, const char *s2) {
+ while (true) {
+ int diff = *(uint8_t *)s1 - *(uint8_t *)s2;
+ if (likely(diff != 0) || *s1 == '\0')
+ return diff;
+ s1 += 1;
+ s2 += 1;
+ }
+}
+
+int __hot mdbx_e2k_strncmp_bug_workaround(const char *s1, const char *s2,
+ size_t n) {
+ while (n > 0) {
+ int diff = *(uint8_t *)s1 - *(uint8_t *)s2;
+ if (likely(diff != 0) || *s1 == '\0')
+ return diff;
+ s1 += 1;
+ s2 += 1;
+ n -= 1;
+ }
+ return 0;
+}
+
+size_t __hot mdbx_e2k_strlen_bug_workaround(const char *s) {
+ size_t n = 0;
+ while (*s) {
+ s += 1;
+ n += 1;
+ }
+ return n;
+}
+
+size_t __hot mdbx_e2k_strnlen_bug_workaround(const char *s, size_t maxlen) {
+ size_t n = 0;
+ while (maxlen > n && *s) {
+ s += 1;
+ n += 1;
+ }
+ return n;
+}
+#endif /* Elbrus's memcmp() bug. */
+
+/*------------------------------------------------------------------------------
+ * safe read/write volatile 64-bit fields on 32-bit architectures. */
+
+static __inline void atomic_yield(void) {
+#if defined(_WIN32) || defined(_WIN64)
+ YieldProcessor();
+#elif defined(__x86_64__) || defined(__i386__) || defined(__e2k__)
+ __builtin_ia32_pause();
+#elif defined(__ia64__)
+#if defined(__HP_cc__) || defined(__HP_aCC__)
+ _Asm_hint(_HINT_PAUSE);
+#else
+ __asm__ __volatile__("hint @pause");
+#endif
+#elif defined(__arm__) || defined(__aarch64__)
+#ifdef __CC_ARM
+ __yield();
+#else
+ __asm__ __volatile__("yield");
+#endif
+#elif (defined(__mips64) || defined(__mips64__)) && defined(__mips_isa_rev) && \
+ __mips_isa_rev >= 2
+ __asm__ __volatile__("pause");
+#elif defined(__mips) || defined(__mips__) || defined(__mips64) || \
+ defined(__mips64__) || defined(_M_MRX000) || defined(_MIPS_) || \
+ defined(__MWERKS__) || defined(__sgi)
+ __asm__ __volatile__(".word 0x00000140");
+#else
+ pthread_yield();
+#endif
+}
+
+#if MDBX_64BIT_CAS
+static __inline bool atomic_cas64(volatile uint64_t *p, uint64_t c,
+ uint64_t v) {
+#if defined(ATOMIC_VAR_INIT) || defined(ATOMIC_LLONG_LOCK_FREE)
+ STATIC_ASSERT(sizeof(long long int) == 8);
+ STATIC_ASSERT(atomic_is_lock_free(p));
+ return atomic_compare_exchange_strong((_Atomic uint64_t *)p, &c, v);
+#elif defined(__GNUC__) || defined(__clang__)
+ return __sync_bool_compare_and_swap(p, c, v);
+#elif defined(_MSC_VER)
+ return c ==
+ (uint64_t)_InterlockedCompareExchange64((volatile int64_t *)p, v, c);
+#elif defined(__APPLE__)
+ return OSAtomicCompareAndSwap64Barrier(c, v, (volatile uint64_t *)p);
+#else
+#error FIXME: Unsupported compiler
+#endif
+}
+#endif /* MDBX_64BIT_CAS */
+
+static __inline bool atomic_cas32(volatile uint32_t *p, uint32_t c,
+ uint32_t v) {
+#if defined(ATOMIC_VAR_INIT) || defined(ATOMIC_LONG_LOCK_FREE)
+ STATIC_ASSERT(sizeof(long int) >= 4);
+ STATIC_ASSERT(atomic_is_lock_free(p));
+ return atomic_compare_exchange_strong((_Atomic uint32_t *)p, &c, v);
+#elif defined(__GNUC__) || defined(__clang__)
+ return __sync_bool_compare_and_swap(p, c, v);
+#elif defined(_MSC_VER)
+ STATIC_ASSERT(sizeof(volatile long) == sizeof(volatile uint32_t));
+ return c == (uint32_t)_InterlockedCompareExchange((volatile long *)p, v, c);
+#elif defined(__APPLE__)
+ return OSAtomicCompareAndSwap32Barrier(c, v, (volatile int32_t *)p);
+#else
+#error FIXME: Unsupported compiler
+#endif
+}
+
+static __inline uint32_t atomic_add32(volatile uint32_t *p, uint32_t v) {
+#if defined(ATOMIC_VAR_INIT) || defined(ATOMIC_LONG_LOCK_FREE)
+ STATIC_ASSERT(sizeof(long int) >= 4);
+ STATIC_ASSERT(atomic_is_lock_free(p));
+ return atomic_fetch_add((_Atomic uint32_t *)p, v);
+#elif defined(__GNUC__) || defined(__clang__)
+ return __sync_fetch_and_add(p, v);
+#elif defined(_MSC_VER)
+ STATIC_ASSERT(sizeof(volatile long) == sizeof(volatile uint32_t));
+ return _InterlockedExchangeAdd((volatile long *)p, v);
+#elif defined(__APPLE__)
+ return OSAtomicAdd32Barrier(v, (volatile int32_t *)p);
+#else
+#error FIXME: Unsupported compiler
+#endif
+}
+
+#define atomic_sub32(p, v) atomic_add32(p, 0 - (v))
+
+static __maybe_unused __inline bool safe64_is_valid(uint64_t v) {
+#if MDBX_WORDBITS >= 64
+ return v < SAFE64_INVALID_THRESHOLD;
+#else
+ return (v >> 32) != UINT32_MAX;
+#endif /* MDBX_WORDBITS */
+}
+
+static __maybe_unused __inline bool
+safe64_is_valid_ptr(const mdbx_safe64_t *ptr) {
+ mdbx_compiler_barrier();
+#if MDBX_64BIT_ATOMIC
+ return ptr->atomic < SAFE64_INVALID_THRESHOLD;
+#else
+ return ptr->high != UINT32_MAX;
+#endif /* MDBX_64BIT_ATOMIC */
+}
+
+static __inline uint64_t safe64_txnid_next(uint64_t txnid) {
+ txnid += MDBX_TXNID_STEP;
+#if !MDBX_64BIT_CAS
+ /* avoid overflow of low-part in safe64_reset() */
+ txnid += (UINT32_MAX == (uint32_t)txnid);
+#endif
+ return txnid;
+}
+
+static __inline void safe64_reset(mdbx_safe64_t *ptr, bool single_writer) {
+ mdbx_compiler_barrier();
+#if !MDBX_64BIT_CAS
+ if (!single_writer) {
+ STATIC_ASSERT(MDBX_TXNID_STEP > 1);
+ /* it is safe to increment low-part to avoid ABA, since MDBX_TXNID_STEP > 1
+ * and overflow was preserved in safe64_txnid_next() */
+ atomic_add32(&ptr->low, 1) /* avoid ABA in safe64_reset_compare() */;
+ ptr->high = UINT32_MAX /* atomically make >= SAFE64_INVALID_THRESHOLD */;
+ atomic_add32(&ptr->low, 1) /* avoid ABA in safe64_reset_compare() */;
+ } else
+#else
+ (void)single_writer;
+#endif /* !MDBX_64BIT_CAS */
+#if MDBX_64BIT_ATOMIC
+ ptr->atomic = UINT64_MAX;
+#else
+ /* atomically make value >= SAFE64_INVALID_THRESHOLD */
+ ptr->high = UINT32_MAX;
+#endif /* MDBX_64BIT_ATOMIC */
+ assert(ptr->inconsistent >= SAFE64_INVALID_THRESHOLD);
+ mdbx_flush_noncoherent_cpu_writeback();
+ mdbx_jitter4testing(true);
+}
+
+static __inline bool safe64_reset_compare(mdbx_safe64_t *ptr, txnid_t compare) {
+ mdbx_compiler_barrier();
+ /* LY: This function is used to reset `mr_txnid` from OOM-kick in case
+ * the asynchronously cancellation of read transaction. Therefore,
+ * there may be a collision between the cleanup performed here and
+ * asynchronous termination and restarting of the read transaction
+ * in another proces/thread. In general we MUST NOT reset the `mr_txnid`
+ * if a new transaction was started (i.e. if `mr_txnid` was changed). */
+#if MDBX_64BIT_CAS
+ bool rc = atomic_cas64(&ptr->inconsistent, compare, UINT64_MAX);
+ mdbx_flush_noncoherent_cpu_writeback();
+#else
+ /* LY: There is no gold ratio here since shared mutex is too costly,
+ * in such way we must acquire/release it for every update of mr_txnid,
+ * i.e. twice for each read transaction). */
+ bool rc = false;
+ if (likely(ptr->low == (uint32_t)compare &&
+ atomic_cas32(&ptr->high, (uint32_t)(compare >> 32), UINT32_MAX))) {
+ if (unlikely(ptr->low != (uint32_t)compare))
+ atomic_cas32(&ptr->high, UINT32_MAX, (uint32_t)(compare >> 32));
+ else
+ rc = true;
+ }
+#endif /* MDBX_64BIT_CAS */
+ mdbx_jitter4testing(true);
+ return rc;
+}
+
+static __inline void safe64_write(mdbx_safe64_t *ptr, const uint64_t v) {
+ mdbx_compiler_barrier();
+ assert(ptr->inconsistent >= SAFE64_INVALID_THRESHOLD);
+#if MDBX_64BIT_ATOMIC
+ ptr->atomic = v;
+#else /* MDBX_64BIT_ATOMIC */
+ /* update low-part but still value >= SAFE64_INVALID_THRESHOLD */
+ ptr->low = (uint32_t)v;
+ assert(ptr->inconsistent >= SAFE64_INVALID_THRESHOLD);
+ mdbx_flush_noncoherent_cpu_writeback();
+ mdbx_jitter4testing(true);
+ /* update high-part from SAFE64_INVALID_THRESHOLD to actual value */
+ ptr->high = (uint32_t)(v >> 32);
+#endif /* MDBX_64BIT_ATOMIC */
+ assert(ptr->inconsistent == v);
+ mdbx_flush_noncoherent_cpu_writeback();
+ mdbx_jitter4testing(true);
+}
+
+static __always_inline uint64_t safe64_read(const mdbx_safe64_t *ptr) {
+ mdbx_compiler_barrier();
+ mdbx_jitter4testing(true);
+ uint64_t v;
+#if MDBX_64BIT_ATOMIC
+ v = ptr->atomic;
+#else /* MDBX_64BIT_ATOMIC */
+ uint32_t hi, lo;
+ do {
+ hi = ptr->high;
+ mdbx_compiler_barrier();
+ mdbx_jitter4testing(true);
+ lo = ptr->low;
+ mdbx_compiler_barrier();
+ mdbx_jitter4testing(true);
+ } while (unlikely(hi != ptr->high));
+ v = lo | (uint64_t)hi << 32;
+#endif /* MDBX_64BIT_ATOMIC */
+ mdbx_jitter4testing(true);
+ return v;
+}
+
+static __inline void safe64_update(mdbx_safe64_t *ptr, const uint64_t v) {
+ safe64_reset(ptr, true);
+ safe64_write(ptr, v);
+}
+
+/*----------------------------------------------------------------------------*/
+/* rthc (tls keys and destructors) */
+
+typedef struct rthc_entry_t {
+ MDBX_reader *begin;
+ MDBX_reader *end;
+ mdbx_thread_key_t thr_tls_key;
+ bool key_valid;
+} rthc_entry_t;
+
+#if MDBX_DEBUG
+#define RTHC_INITIAL_LIMIT 1
+#else
+#define RTHC_INITIAL_LIMIT 16
+#endif
+
+static bin128_t bootid;
+#if defined(_WIN32) || defined(_WIN64)
+static CRITICAL_SECTION rthc_critical_section;
+static CRITICAL_SECTION lcklist_critical_section;
+#else
+int __cxa_thread_atexit_impl(void (*dtor)(void *), void *obj, void *dso_symbol)
+ __attribute__((__weak__));
+#ifdef __APPLE__ /* FIXME: Thread-Local Storage destructors & DSO-unloading */
+int __cxa_thread_atexit_impl(void (*dtor)(void *), void *obj,
+ void *dso_symbol) {
+ (void)dtor;
+ (void)obj;
+ (void)dso_symbol;
+ return -1;
+}
+#endif /* __APPLE__ */
+
+static pthread_mutex_t lcklist_mutex = PTHREAD_MUTEX_INITIALIZER;
+static pthread_mutex_t rthc_mutex = PTHREAD_MUTEX_INITIALIZER;
+static pthread_cond_t rthc_cond = PTHREAD_COND_INITIALIZER;
+static mdbx_thread_key_t rthc_key;
+static volatile uint32_t rthc_pending;
+
+static void __cold workaround_glibc_bug21031(void) {
+ /* Workaround for https://sourceware.org/bugzilla/show_bug.cgi?id=21031
+ *
+ * Due race between pthread_key_delete() and __nptl_deallocate_tsd()
+ * The destructor(s) of thread-local-storate object(s) may be running
+ * in another thread(s) and be blocked or not finished yet.
+ * In such case we get a SEGFAULT after unload this library DSO.
+ *
+ * So just by yielding a few timeslices we give a chance
+ * to such destructor(s) for completion and avoids segfault. */
+ sched_yield();
+ sched_yield();
+ sched_yield();
+}
+#endif
+
+static unsigned rthc_count, rthc_limit;
+static rthc_entry_t *rthc_table;
+static rthc_entry_t rthc_table_static[RTHC_INITIAL_LIMIT];
+
+static __inline void rthc_lock(void) {
+#if defined(_WIN32) || defined(_WIN64)
+ EnterCriticalSection(&rthc_critical_section);
+#else
+ mdbx_ensure(nullptr, pthread_mutex_lock(&rthc_mutex) == 0);
+#endif
+}
+
+static __inline void rthc_unlock(void) {
+#if defined(_WIN32) || defined(_WIN64)
+ LeaveCriticalSection(&rthc_critical_section);
+#else
+ mdbx_ensure(nullptr, pthread_mutex_unlock(&rthc_mutex) == 0);
+#endif
+}
+
+static __inline int thread_key_create(mdbx_thread_key_t *key) {
+ int rc;
+#if defined(_WIN32) || defined(_WIN64)
+ *key = TlsAlloc();
+ rc = (*key != TLS_OUT_OF_INDEXES) ? MDBX_SUCCESS : GetLastError();
+#else
+ rc = pthread_key_create(key, nullptr);
+#endif
+ mdbx_trace("&key = %p, value 0x%x, rc %d", __Wpedantic_format_voidptr(key),
+ (unsigned)*key, rc);
+ return rc;
+}
+
+static __inline void thread_key_delete(mdbx_thread_key_t key) {
+ mdbx_trace("key = 0x%x", (unsigned)key);
+#if defined(_WIN32) || defined(_WIN64)
+ mdbx_ensure(nullptr, TlsFree(key));
+#else
+ mdbx_ensure(nullptr, pthread_key_delete(key) == 0);
+ workaround_glibc_bug21031();
+#endif
+}
+
+static __inline void *thread_rthc_get(mdbx_thread_key_t key) {
+#if defined(_WIN32) || defined(_WIN64)
+ return TlsGetValue(key);
+#else
+ return pthread_getspecific(key);
+#endif
+}
+
+static void thread_rthc_set(mdbx_thread_key_t key, const void *value) {
+#if defined(_WIN32) || defined(_WIN64)
+ mdbx_ensure(nullptr, TlsSetValue(key, (void *)value));
+#else
+#define MDBX_THREAD_RTHC_ZERO 0
+#define MDBX_THREAD_RTHC_REGISTERD 1
+#define MDBX_THREAD_RTHC_COUNTED 2
+ static __thread uint32_t thread_registration_state;
+ if (value && unlikely(thread_registration_state == MDBX_THREAD_RTHC_ZERO)) {
+ thread_registration_state = MDBX_THREAD_RTHC_REGISTERD;
+ mdbx_trace("thread registered 0x%" PRIxPTR, (uintptr_t)mdbx_thread_self());
+ if (&__cxa_thread_atexit_impl == nullptr ||
+ __cxa_thread_atexit_impl(mdbx_rthc_thread_dtor,
+ &thread_registration_state,
+ (void *)&mdbx_version /* dso_anchor */)) {
+ mdbx_ensure(nullptr, pthread_setspecific(
+ rthc_key, &thread_registration_state) == 0);
+ thread_registration_state = MDBX_THREAD_RTHC_COUNTED;
+ const unsigned count_before = atomic_add32(&rthc_pending, 1);
+ mdbx_ensure(nullptr, count_before < INT_MAX);
+ mdbx_trace("fallback to pthreads' tsd, key 0x%x, count %u",
+ (unsigned)rthc_key, count_before);
+ (void)count_before;
+ }
+ }
+ mdbx_ensure(nullptr, pthread_setspecific(key, value) == 0);
+#endif
+}
+
+__cold void mdbx_rthc_global_init(void) {
+ rthc_limit = RTHC_INITIAL_LIMIT;
+ rthc_table = rthc_table_static;
+#if defined(_WIN32) || defined(_WIN64)
+ InitializeCriticalSection(&rthc_critical_section);
+ InitializeCriticalSection(&lcklist_critical_section);
+#else
+ mdbx_ensure(nullptr,
+ pthread_key_create(&rthc_key, mdbx_rthc_thread_dtor) == 0);
+ mdbx_trace("pid %d, &mdbx_rthc_key = %p, value 0x%x", mdbx_getpid(),
+ __Wpedantic_format_voidptr(&rthc_key), (unsigned)rthc_key);
+#endif
+ /* checking time conversion, this also avoids racing on 32-bit architectures
+ * during writing calculated 64-bit ratio(s) into memory. */
+ uint32_t proba = UINT32_MAX;
+ while (true) {
+ unsigned time_conversion_checkup =
+ mdbx_osal_monotime_to_16dot16(mdbx_osal_16dot16_to_monotime(proba));
+ unsigned one_more = (proba < UINT32_MAX) ? proba + 1 : proba;
+ unsigned one_less = (proba > 0) ? proba - 1 : proba;
+ mdbx_ensure(nullptr, time_conversion_checkup >= one_less &&
+ time_conversion_checkup <= one_more);
+ if (proba == 0)
+ break;
+ proba >>= 1;
+ }
+
+ bootid = mdbx_osal_bootid();
+}
+
+/* dtor called for thread, i.e. for all mdbx's environment objects */
+__cold void mdbx_rthc_thread_dtor(void *ptr) {
+ rthc_lock();
+ mdbx_trace(">> pid %d, thread 0x%" PRIxPTR ", rthc %p", mdbx_getpid(),
+ (uintptr_t)mdbx_thread_self(), ptr);
+
+ const uint32_t self_pid = mdbx_getpid();
+ for (unsigned i = 0; i < rthc_count; ++i) {
+ if (!rthc_table[i].key_valid)
+ continue;
+ const mdbx_thread_key_t key = rthc_table[i].thr_tls_key;
+ MDBX_reader *const rthc = thread_rthc_get(key);
+ if (rthc < rthc_table[i].begin || rthc >= rthc_table[i].end)
+ continue;
+#if !defined(_WIN32) && !defined(_WIN64)
+ if (pthread_setspecific(key, nullptr) != 0) {
+ mdbx_trace("== thread 0x%" PRIxPTR
+ ", rthc %p: ignore race with tsd-key deletion",
+ (uintptr_t)mdbx_thread_self(), ptr);
+ continue /* ignore race with tsd-key deletion by mdbx_env_close() */;
+ }
+#endif
+
+ mdbx_trace("== thread 0x%" PRIxPTR
+ ", rthc %p, [%i], %p ... %p (%+i), rtch-pid %i, "
+ "current-pid %i",
+ (uintptr_t)mdbx_thread_self(), __Wpedantic_format_voidptr(rthc),
+ i, __Wpedantic_format_voidptr(rthc_table[i].begin),
+ __Wpedantic_format_voidptr(rthc_table[i].end),
+ (int)(rthc - rthc_table[i].begin), rthc->mr_pid, self_pid);
+ if (rthc->mr_pid == self_pid) {
+ mdbx_trace("==== thread 0x%" PRIxPTR ", rthc %p, cleanup",
+ (uintptr_t)mdbx_thread_self(),
+ __Wpedantic_format_voidptr(rthc));
+ rthc->mr_pid = 0;
+ }
+ }
+
+#if defined(_WIN32) || defined(_WIN64)
+ mdbx_trace("<< thread 0x%" PRIxPTR ", rthc %p", (uintptr_t)mdbx_thread_self(),
+ ptr);
+ rthc_unlock();
+#else
+ const char self_registration = *(char *)ptr;
+ *(char *)ptr = MDBX_THREAD_RTHC_ZERO;
+ mdbx_trace("== thread 0x%" PRIxPTR ", rthc %p, pid %d, self-status %d",
+ (uintptr_t)mdbx_thread_self(), ptr, mdbx_getpid(),
+ self_registration);
+ if (self_registration == MDBX_THREAD_RTHC_COUNTED)
+ mdbx_ensure(nullptr, atomic_sub32(&rthc_pending, 1) > 0);
+
+ if (rthc_pending == 0) {
+ mdbx_trace("== thread 0x%" PRIxPTR ", rthc %p, pid %d, wake",
+ (uintptr_t)mdbx_thread_self(), ptr, mdbx_getpid());
+ mdbx_ensure(nullptr, pthread_cond_broadcast(&rthc_cond) == 0);
+ }
+
+ mdbx_trace("<< thread 0x%" PRIxPTR ", rthc %p", (uintptr_t)mdbx_thread_self(),
+ ptr);
+ /* Allow tail call optimization, i.e. gcc should generate the jmp instruction
+ * instead of a call for pthread_mutex_unlock() and therefore CPU could not
+ * return to current DSO's code section, which may be unloaded immediately
+ * after the mutex got released. */
+ pthread_mutex_unlock(&rthc_mutex);
+#endif
+}
+
+__cold void mdbx_rthc_global_dtor(void) {
+ mdbx_trace(">> pid %d", mdbx_getpid());
+
+ rthc_lock();
+#if !defined(_WIN32) && !defined(_WIN64)
+ char *rthc = (char *)pthread_getspecific(rthc_key);
+ mdbx_trace("== thread 0x%" PRIxPTR ", rthc %p, pid %d, self-status %d",
+ (uintptr_t)mdbx_thread_self(), __Wpedantic_format_voidptr(rthc),
+ mdbx_getpid(), rthc ? *rthc : -1);
+ if (rthc) {
+ const char self_registration = *(char *)rthc;
+ *rthc = MDBX_THREAD_RTHC_ZERO;
+ if (self_registration == MDBX_THREAD_RTHC_COUNTED)
+ mdbx_ensure(nullptr, atomic_sub32(&rthc_pending, 1) > 0);
+ }
+
+ struct timespec abstime;
+ mdbx_ensure(nullptr, clock_gettime(CLOCK_REALTIME, &abstime) == 0);
+ abstime.tv_nsec += 1000000000l / 10;
+ if (abstime.tv_nsec >= 1000000000l) {
+ abstime.tv_nsec -= 1000000000l;
+ abstime.tv_sec += 1;
+ }
+#if MDBX_DEBUG > 0
+ abstime.tv_sec += 600;
+#endif
+
+ for (unsigned left; (left = rthc_pending) > 0;) {
+ mdbx_trace("pid %d, pending %u, wait for...", mdbx_getpid(), left);
+ const int rc = pthread_cond_timedwait(&rthc_cond, &rthc_mutex, &abstime);
+ if (rc && rc != EINTR)
+ break;
+ }
+ thread_key_delete(rthc_key);
+#endif
+
+ const uint32_t self_pid = mdbx_getpid();
+ for (unsigned i = 0; i < rthc_count; ++i) {
+ if (!rthc_table[i].key_valid)
+ continue;
+ const mdbx_thread_key_t key = rthc_table[i].thr_tls_key;
+ thread_key_delete(key);
+ for (MDBX_reader *rthc = rthc_table[i].begin; rthc < rthc_table[i].end;
+ ++rthc) {
+ mdbx_trace("== [%i] = key %zu, %p ... %p, rthc %p (%+i), "
+ "rthc-pid %i, current-pid %i",
+ i, (size_t)key,
+ __Wpedantic_format_voidptr(rthc_table[i].begin),
+ __Wpedantic_format_voidptr(rthc_table[i].end),
+ __Wpedantic_format_voidptr(rthc),
+ (int)(rthc - rthc_table[i].begin), rthc->mr_pid, self_pid);
+ if (rthc->mr_pid == self_pid) {
+ rthc->mr_pid = 0;
+ mdbx_trace("== cleanup %p", __Wpedantic_format_voidptr(rthc));
+ }
+ }
+ }
+
+ rthc_limit = rthc_count = 0;
+ if (rthc_table != rthc_table_static)
+ mdbx_free(rthc_table);
+ rthc_table = nullptr;
+ rthc_unlock();
+
+#if defined(_WIN32) || defined(_WIN64)
+ DeleteCriticalSection(&lcklist_critical_section);
+ DeleteCriticalSection(&rthc_critical_section);
+#else
+ /* LY: yielding a few timeslices to give a more chance
+ * to racing destructor(s) for completion. */
+ workaround_glibc_bug21031();
+#endif
+
+ mdbx_trace("<< pid %d\n", mdbx_getpid());
+}
+
+__cold int mdbx_rthc_alloc(mdbx_thread_key_t *key, MDBX_reader *begin,
+ MDBX_reader *end) {
+ int rc;
+ if (key) {
+#ifndef NDEBUG
+ *key = (mdbx_thread_key_t)0xBADBADBAD;
+#endif /* NDEBUG */
+ rc = thread_key_create(key);
+ if (rc != MDBX_SUCCESS)
+ return rc;
+ }
+
+ rthc_lock();
+ const mdbx_thread_key_t new_key = key ? *key : 0;
+ mdbx_trace(">> key %zu, rthc_count %u, rthc_limit %u", (size_t)new_key,
+ rthc_count, rthc_limit);
+ if (rthc_count == rthc_limit) {
+ rthc_entry_t *new_table =
+ mdbx_realloc((rthc_table == rthc_table_static) ? nullptr : rthc_table,
+ sizeof(rthc_entry_t) * rthc_limit * 2);
+ if (new_table == nullptr) {
+ rc = MDBX_ENOMEM;
+ goto bailout;
+ }
+ if (rthc_table == rthc_table_static)
+ memcpy(new_table, rthc_table_static, sizeof(rthc_table_static));
+ rthc_table = new_table;
+ rthc_limit *= 2;
+ }
+ mdbx_trace("== [%i] = key %zu, %p ... %p", rthc_count, (size_t)new_key,
+ __Wpedantic_format_voidptr(begin),
+ __Wpedantic_format_voidptr(end));
+ rthc_table[rthc_count].key_valid = key ? true : false;
+ rthc_table[rthc_count].thr_tls_key = key ? new_key : 0;
+ rthc_table[rthc_count].begin = begin;
+ rthc_table[rthc_count].end = end;
+ ++rthc_count;
+ mdbx_trace("<< key %zu, rthc_count %u, rthc_limit %u", (size_t)new_key,
+ rthc_count, rthc_limit);
+ rthc_unlock();
+ return MDBX_SUCCESS;
+
+bailout:
+ if (key)
+ thread_key_delete(*key);
+ rthc_unlock();
+ return rc;
+}
+
+__cold void mdbx_rthc_remove(const mdbx_thread_key_t key) {
+ thread_key_delete(key);
+ rthc_lock();
+ mdbx_trace(">> key %zu, rthc_count %u, rthc_limit %u", (size_t)key,
+ rthc_count, rthc_limit);
+
+ for (unsigned i = 0; i < rthc_count; ++i) {
+ if (rthc_table[i].key_valid && key == rthc_table[i].thr_tls_key) {
+ const uint32_t self_pid = mdbx_getpid();
+ mdbx_trace("== [%i], %p ...%p, current-pid %d", i,
+ __Wpedantic_format_voidptr(rthc_table[i].begin),
+ __Wpedantic_format_voidptr(rthc_table[i].end), self_pid);
+
+ for (MDBX_reader *rthc = rthc_table[i].begin; rthc < rthc_table[i].end;
+ ++rthc) {
+ if (rthc->mr_pid == self_pid) {
+ rthc->mr_pid = 0;
+ mdbx_trace("== cleanup %p", __Wpedantic_format_voidptr(rthc));
+ }
+ }
+ if (--rthc_count > 0)
+ rthc_table[i] = rthc_table[rthc_count];
+ else if (rthc_table != rthc_table_static) {
+ mdbx_free(rthc_table);
+ rthc_table = rthc_table_static;
+ rthc_limit = RTHC_INITIAL_LIMIT;
+ }
+ break;
+ }
+ }
+
+ mdbx_trace("<< key %zu, rthc_count %u, rthc_limit %u", (size_t)key,
+ rthc_count, rthc_limit);
+ rthc_unlock();
+}
+
+//------------------------------------------------------------------------------
+
+#define RTHC_ENVLIST_END ((MDBX_env *)((size_t)50459))
+static MDBX_env *inprocess_lcklist_head = RTHC_ENVLIST_END;
+
+static __inline void lcklist_lock(void) {
+#if defined(_WIN32) || defined(_WIN64)
+ EnterCriticalSection(&lcklist_critical_section);
+#else
+ mdbx_ensure(nullptr, pthread_mutex_lock(&lcklist_mutex) == 0);
+#endif
+}
+
+static __inline void lcklist_unlock(void) {
+#if defined(_WIN32) || defined(_WIN64)
+ LeaveCriticalSection(&lcklist_critical_section);
+#else
+ mdbx_ensure(nullptr, pthread_mutex_unlock(&lcklist_mutex) == 0);
+#endif
+}
+
+static uint64_t rrxmrrxmsx_0(uint64_t v) {
+ /* Pelle Evensen's mixer, https://bit.ly/2HOfynt */
+ v ^= (v << 39 | v >> 25) ^ (v << 14 | v >> 50);
+ v *= UINT64_C(0xA24BAED4963EE407);
+ v ^= (v << 40 | v >> 24) ^ (v << 15 | v >> 49);
+ v *= UINT64_C(0x9FB21C651E98DF25);
+ return v ^ v >> 28;
+}
+
+static int uniq_peek(const mdbx_mmap_t *pending, mdbx_mmap_t *scan) {
+ int rc;
+ uint64_t bait;
+ if (pending->address) {
+ bait = pending->lck->mti_bait_uniqueness;
+ rc = MDBX_SUCCESS;
+ } else {
+ bait = 0 /* hush MSVC warning */;
+ rc = mdbx_msync(scan, 0, sizeof(MDBX_lockinfo), true);
+ if (rc == MDBX_SUCCESS)
+ rc =
+ mdbx_pread(pending->fd, &bait, sizeof(scan->lck->mti_bait_uniqueness),
+ offsetof(MDBX_lockinfo, mti_bait_uniqueness));
+ }
+ if (likely(rc == MDBX_SUCCESS) && bait == scan->lck->mti_bait_uniqueness)
+ rc = MDBX_RESULT_TRUE;
+
+ mdbx_trace("uniq-peek: %s, bait 0x%016" PRIx64 ",%s rc %d",
+ pending->lck ? "mem" : "file", bait,
+ (rc == MDBX_RESULT_TRUE) ? " found," : (rc ? " FAILED," : ""), rc);
+ return rc;
+}
+
+static int uniq_poke(const mdbx_mmap_t *pending, mdbx_mmap_t *scan,
+ uint64_t *abra) {
+ if (*abra == 0) {
+ const size_t tid = mdbx_thread_self();
+ size_t uit = 0;
+ memcpy(&uit, &tid, (sizeof(tid) < sizeof(uit)) ? sizeof(tid) : sizeof(uit));
+ *abra =
+ rrxmrrxmsx_0(mdbx_osal_monotime() + UINT64_C(5873865991930747) * uit);
+ }
+ const uint64_t cadabra =
+ rrxmrrxmsx_0(*abra + UINT64_C(7680760450171793) * (unsigned)mdbx_getpid())
+ << 24 |
+ *abra >> 40;
+ scan->lck->mti_bait_uniqueness = cadabra;
+ mdbx_flush_noncoherent_cpu_writeback();
+ *abra = *abra * UINT64_C(6364136223846793005) + 1;
+ return uniq_peek(pending, scan);
+}
+
+__cold static int uniq_check(const mdbx_mmap_t *pending, MDBX_env **found) {
+ *found = nullptr;
+ uint64_t salt = 0;
+ for (MDBX_env *scan = inprocess_lcklist_head; scan != RTHC_ENVLIST_END;
+ scan = scan->me_lcklist_next) {
+ int err = scan->me_lck_mmap.lck->mti_bait_uniqueness
+ ? uniq_peek(pending, &scan->me_lck_mmap)
+ : uniq_poke(pending, &scan->me_lck_mmap, &salt);
+ if (err == MDBX_ENODATA) {
+ uint64_t length;
+ if (likely(mdbx_filesize(pending->fd, &length) == MDBX_SUCCESS &&
+ length == 0)) {
+ /* LY: skip checking since LCK-file is empty, i.e. just created. */
+ mdbx_debug("uniq-probe: %s", "unique (new/empty lck)");
+ return MDBX_RESULT_TRUE;
+ }
+ }
+ if (err == MDBX_RESULT_TRUE)
+ err = uniq_poke(pending, &scan->me_lck_mmap, &salt);
+ if (err == MDBX_RESULT_TRUE) {
+ (void)mdbx_msync(&scan->me_lck_mmap, 0, sizeof(MDBX_lockinfo), false);
+ err = uniq_poke(pending, &scan->me_lck_mmap, &salt);
+ }
+ if (err == MDBX_RESULT_TRUE) {
+ err = uniq_poke(pending, &scan->me_lck_mmap, &salt);
+ *found = scan;
+ mdbx_debug("uniq-probe: found %p", __Wpedantic_format_voidptr(*found));
+ return MDBX_RESULT_FALSE;
+ }
+ if (unlikely(err != MDBX_SUCCESS)) {
+ mdbx_debug("uniq-probe: failed rc %d", err);
+ return err;
+ }
+ }
+
+ mdbx_debug("uniq-probe: %s", "unique");
+ return MDBX_RESULT_TRUE;
+}
+
+static int lcklist_detach_locked(MDBX_env *env) {
+ MDBX_env *inprocess_neighbor = nullptr;
+ int rc = MDBX_SUCCESS;
+ if (env->me_lcklist_next != nullptr) {
+ mdbx_ensure(env, env->me_lcklist_next != nullptr);
+ mdbx_ensure(env, inprocess_lcklist_head != RTHC_ENVLIST_END);
+ for (MDBX_env **ptr = &inprocess_lcklist_head; *ptr != RTHC_ENVLIST_END;
+ ptr = &(*ptr)->me_lcklist_next) {
+ if (*ptr == env) {
+ *ptr = env->me_lcklist_next;
+ env->me_lcklist_next = nullptr;
+ break;
+ }
+ }
+ mdbx_ensure(env, env->me_lcklist_next == nullptr);
+ }
+
+ rc = likely(mdbx_getpid() == env->me_pid)
+ ? uniq_check(&env->me_lck_mmap, &inprocess_neighbor)
+ : MDBX_PANIC;
+ if (!inprocess_neighbor && env->me_live_reader)
+ (void)mdbx_rpid_clear(env);
+ if (!MDBX_IS_ERROR(rc))
+ rc = mdbx_lck_destroy(env, inprocess_neighbor);
+ return rc;
+}
+
+/*------------------------------------------------------------------------------
+ * LY: State of the art quicksort-based sorting, with internal stack and
+ * shell-insertion-sort for small chunks (less than half of SORT_THRESHOLD).
+ */
+
+/* LY: Large threshold give some boost due less overhead in the inner qsort
+ * loops, but also a penalty in cases reverse-sorted data.
+ * So, 42 is magically but reasonable:
+ * - 0-3% faster than std::sort (from GNU C++ STL 2018) in most cases.
+ * - slower by a few ticks in a few cases for sequences shorter than 21. */
+#define SORT_THRESHOLD 42
+
+#define SORT_SWAP(TYPE, a, b) \
+ do { \
+ const TYPE swap_tmp = (a); \
+ (a) = (b); \
+ (b) = swap_tmp; \
+ } while (0)
+
+#define SORT_SHELLPASS(TYPE, CMP, begin, end, gap) \
+ for (TYPE *i = begin + gap; i < end; ++i) { \
+ for (TYPE *j = i - (gap); j >= begin && CMP(*i, *j); j -= gap) { \
+ const TYPE tmp = *i; \
+ do { \
+ j[gap] = *j; \
+ j -= gap; \
+ } while (j >= begin && CMP(tmp, *j)); \
+ j[gap] = tmp; \
+ break; \
+ } \
+ }
+
+#define SORT_PUSH(low, high) \
+ do { \
+ top->lo = (low); \
+ top->hi = (high); \
+ ++top; \
+ } while (0)
+
+#define SORT_POP(low, high) \
+ do { \
+ --top; \
+ low = top->lo; \
+ high = top->hi; \
+ } while (0)
+
+#define SORT_IMPL(NAME, TYPE, CMP) \
+ \
+ typedef struct { \
+ TYPE *lo, *hi; \
+ } NAME##_stack; \
+ \
+ static __hot void NAME(TYPE *const begin, TYPE *const end) { \
+ const ptrdiff_t length = end - begin; \
+ if (length < 2) \
+ return; \
+ \
+ if (length > SORT_THRESHOLD / 2) { \
+ NAME##_stack stack[sizeof(unsigned) * CHAR_BIT], *top = stack; \
+ \
+ TYPE *hi = end - 1; \
+ TYPE *lo = begin; \
+ while (true) { \
+ TYPE *mid = lo + ((hi - lo) >> 1); \
+ if (CMP(*mid, *lo)) \
+ SORT_SWAP(TYPE, *mid, *lo); \
+ if (CMP(*hi, *mid)) { \
+ SORT_SWAP(TYPE, *hi, *mid); \
+ if (CMP(*mid, *lo)) \
+ SORT_SWAP(TYPE, *mid, *lo); \
+ } \
+ \
+ TYPE *right = hi - 1; \
+ TYPE *left = lo + 1; \
+ do { \
+ while (CMP(*mid, *right)) \
+ --right; \
+ while (CMP(*left, *mid)) \
+ ++left; \
+ if (left < right) { \
+ SORT_SWAP(TYPE, *left, *right); \
+ if (mid == left) \
+ mid = right; \
+ else if (mid == right) \
+ mid = left; \
+ ++left; \
+ --right; \
+ } else if (left == right) { \
+ ++left; \
+ --right; \
+ break; \
+ } \
+ } while (left <= right); \
+ \
+ if (lo + SORT_THRESHOLD > right) { \
+ if (left + SORT_THRESHOLD > hi) { \
+ if (top == stack) \
+ break; \
+ else \
+ SORT_POP(lo, hi); \
+ } else \
+ lo = left; \
+ } else if (left + SORT_THRESHOLD > hi) \
+ hi = right; \
+ else if (right - lo > hi - left) { \
+ SORT_PUSH(lo, right); \
+ lo = left; \
+ } else { \
+ SORT_PUSH(left, hi); \
+ hi = right; \
+ } \
+ } \
+ } \
+ \
+ SORT_SHELLPASS(TYPE, CMP, begin, end, 8); \
+ SORT_SHELLPASS(TYPE, CMP, begin, end, 1); \
+ for (TYPE *scan = begin + 1; scan < end; ++scan) \
+ assert(CMP(scan[-1], scan[0])); \
+ }
+
+/*------------------------------------------------------------------------------
+ * LY: Binary search */
+
+#define SEARCH_IMPL(NAME, TYPE_LIST, TYPE_ARG, CMP) \
+ static __always_inline TYPE_LIST *NAME(TYPE_LIST *first, unsigned length, \
+ const TYPE_ARG item) { \
+ TYPE_LIST *const begin = first, *const end = begin + length; \
+ \
+ while (length > 3) { \
+ const unsigned half = length >> 1; \
+ TYPE_LIST *const middle = first + half; \
+ if (CMP(*middle, item)) { \
+ first = middle + 1; \
+ length -= half + 1; \
+ } else \
+ length = half; \
+ } \
+ \
+ switch (length) { \
+ case 3: \
+ if (!CMP(*first, item)) \
+ break; \
+ ++first; \
+ /* fall through */ \
+ __fallthrough; \
+ case 2: \
+ if (!CMP(*first, item)) \
+ break; \
+ ++first; \
+ /* fall through */ \
+ __fallthrough; \
+ case 1: \
+ if (CMP(*first, item)) \
+ ++first; \
+ } \
+ \
+ for (TYPE_LIST *scan = begin; scan < first; ++scan) \
+ assert(CMP(*scan, item)); \
+ for (TYPE_LIST *scan = first; scan < end; ++scan) \
+ assert(!CMP(*scan, item)); \
+ (void)begin, (void)end; \
+ \
+ return first; \
+ }
+
+/*----------------------------------------------------------------------------*/
+
+static __inline size_t pnl2bytes(const size_t size) {
+ assert(size > 0 && size <= MDBX_PNL_MAX * 2);
+ size_t bytes = roundup_powerof2(MDBX_ASSUME_MALLOC_OVERHEAD +
+ sizeof(pgno_t) * (size + 2),
+ MDBX_PNL_GRANULATE * sizeof(pgno_t)) -
+ MDBX_ASSUME_MALLOC_OVERHEAD;
+ return bytes;
+}
+
+static __inline pgno_t bytes2pnl(const size_t bytes) {
+ size_t size = bytes / sizeof(pgno_t);
+ assert(size > 2 && size <= MDBX_PNL_MAX * 2);
+ return (pgno_t)size - 2;
+}
+
+static MDBX_PNL mdbx_pnl_alloc(size_t size) {
+ size_t bytes = pnl2bytes(size);
+ MDBX_PNL pl = mdbx_malloc(bytes);
+ if (likely(pl)) {
+#if __GLIBC_PREREQ(2, 12) || defined(__FreeBSD__) || defined(__OpenBSD__) || \
+ defined(malloc_usable_size)
+ bytes = malloc_usable_size(pl);
+#endif /* malloc_usable_size */
+ pl[0] = bytes2pnl(bytes);
+ assert(pl[0] >= size);
+ pl[1] = 0;
+ pl += 1;
+ }
+ return pl;
+}
+
+static void mdbx_pnl_free(MDBX_PNL pl) {
+ if (likely(pl))
+ mdbx_free(pl - 1);
+}
+
+/* Shrink the PNL to the default size if it has grown larger */
+static void mdbx_pnl_shrink(MDBX_PNL *ppl) {
+ assert(bytes2pnl(pnl2bytes(MDBX_PNL_INITIAL)) == MDBX_PNL_INITIAL);
+ assert(MDBX_PNL_SIZE(*ppl) <= MDBX_PNL_MAX &&
+ MDBX_PNL_ALLOCLEN(*ppl) >= MDBX_PNL_SIZE(*ppl));
+ MDBX_PNL_SIZE(*ppl) = 0;
+ if (unlikely(MDBX_PNL_ALLOCLEN(*ppl) >
+ MDBX_PNL_INITIAL * 2 - MDBX_CACHELINE_SIZE / sizeof(pgno_t))) {
+ size_t bytes = pnl2bytes(MDBX_PNL_INITIAL);
+ MDBX_PNL pl = mdbx_realloc(*ppl - 1, bytes);
+ if (likely(pl)) {
+#if __GLIBC_PREREQ(2, 12) || defined(__FreeBSD__) || defined(__OpenBSD__) || \
+ defined(malloc_usable_size)
+ bytes = malloc_usable_size(pl);
+#endif /* malloc_usable_size */
+ *pl = bytes2pnl(bytes);
+ *ppl = pl + 1;
+ }
+ }
+}
+
+/* Grow the PNL to the size growed to at least given size */
+static int mdbx_pnl_reserve(MDBX_PNL *ppl, const size_t wanna) {
+ const size_t allocated = MDBX_PNL_ALLOCLEN(*ppl);
+ assert(MDBX_PNL_SIZE(*ppl) <= MDBX_PNL_MAX &&
+ MDBX_PNL_ALLOCLEN(*ppl) >= MDBX_PNL_SIZE(*ppl));
+ if (likely(allocated >= wanna))
+ return MDBX_SUCCESS;
+
+ if (unlikely(wanna > /* paranoia */ MDBX_PNL_MAX))
+ return MDBX_TXN_FULL;
+
+ const size_t size = (wanna + wanna - allocated < MDBX_PNL_MAX)
+ ? wanna + wanna - allocated
+ : MDBX_PNL_MAX;
+ size_t bytes = pnl2bytes(size);
+ MDBX_PNL pl = mdbx_realloc(*ppl - 1, bytes);
+ if (likely(pl)) {
+#if __GLIBC_PREREQ(2, 12) || defined(__FreeBSD__) || defined(__OpenBSD__) || \
+ defined(malloc_usable_size)
+ bytes = malloc_usable_size(pl);
+#endif /* malloc_usable_size */
+ *pl = bytes2pnl(bytes);
+ assert(*pl >= wanna);
+ *ppl = pl + 1;
+ return MDBX_SUCCESS;
+ }
+ return MDBX_ENOMEM;
+}
+
+/* Make room for num additional elements in an PNL */
+static __inline int __must_check_result mdbx_pnl_need(MDBX_PNL *ppl,
+ size_t num) {
+ assert(MDBX_PNL_SIZE(*ppl) <= MDBX_PNL_MAX &&
+ MDBX_PNL_ALLOCLEN(*ppl) >= MDBX_PNL_SIZE(*ppl));
+ assert(num <= MDBX_PNL_MAX);
+ const size_t wanna = MDBX_PNL_SIZE(*ppl) + num;
+ return likely(MDBX_PNL_ALLOCLEN(*ppl) >= wanna)
+ ? MDBX_SUCCESS
+ : mdbx_pnl_reserve(ppl, wanna);
+}
+
+static __inline void mdbx_pnl_xappend(MDBX_PNL pl, pgno_t pgno) {
+ assert(MDBX_PNL_SIZE(pl) < MDBX_PNL_ALLOCLEN(pl));
+ if (mdbx_assert_enabled()) {
+ for (unsigned i = MDBX_PNL_SIZE(pl); i > 0; --i)
+ assert(pgno != pl[i]);
+ }
+ MDBX_PNL_SIZE(pl) += 1;
+ MDBX_PNL_LAST(pl) = pgno;
+}
+
+/* Append an pgno onto an unsorted PNL */
+static __hot int __must_check_result mdbx_pnl_append(MDBX_PNL *ppl,
+ pgno_t pgno) {
+ /* Too big? */
+ if (unlikely(MDBX_PNL_SIZE(*ppl) == MDBX_PNL_ALLOCLEN(*ppl))) {
+ int rc = mdbx_pnl_need(ppl, MDBX_PNL_GRANULATE);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+ }
+ mdbx_pnl_xappend(*ppl, pgno);
+ return MDBX_SUCCESS;
+}
+
+/* Append an PNL onto an unsorted PNL */
+static int __must_check_result mdbx_pnl_append_list(MDBX_PNL *ppl,
+ MDBX_PNL append) {
+ const unsigned len = MDBX_PNL_SIZE(append);
+ if (likely(len)) {
+ int rc = mdbx_pnl_need(ppl, MDBX_PNL_SIZE(append));
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ const MDBX_PNL pnl = *ppl;
+ unsigned w = MDBX_PNL_SIZE(pnl), r = 1;
+ do
+ pnl[++w] = append[r];
+ while (++r <= len);
+ MDBX_PNL_SIZE(pnl) = w;
+ }
+ return MDBX_SUCCESS;
+}
+
+/* Append an pgno range onto an unsorted PNL */
+static __hot int __must_check_result mdbx_pnl_append_range(MDBX_PNL *ppl,
+ pgno_t pgno,
+ unsigned n) {
+ assert(n > 0);
+ int rc = mdbx_pnl_need(ppl, n);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ const MDBX_PNL pnl = *ppl;
+#if MDBX_PNL_ASCENDING
+ unsigned w = MDBX_PNL_SIZE(pnl);
+ do
+ pnl[++w] = pgno++;
+ while (--n);
+ MDBX_PNL_SIZE(pnl) = w;
+#else
+ unsigned w = MDBX_PNL_SIZE(pnl) + n;
+ MDBX_PNL_SIZE(pnl) = w;
+ do
+ pnl[w--] = --n + pgno;
+ while (n);
+#endif
+
+ return MDBX_SUCCESS;
+}
+
+/* Append an pgno range into the sorted PNL */
+static __hot int __must_check_result mdbx_pnl_insert_range(MDBX_PNL *ppl,
+ pgno_t pgno,
+ unsigned n) {
+ assert(n > 0);
+ int rc = mdbx_pnl_need(ppl, n);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ const MDBX_PNL pnl = *ppl;
+ unsigned r = MDBX_PNL_SIZE(pnl), w = r + n;
+ MDBX_PNL_SIZE(pnl) = w;
+ while (r && MDBX_PNL_DISORDERED(pnl[r], pgno))
+ pnl[w--] = pnl[r--];
+
+ for (pgno_t fill = MDBX_PNL_ASCENDING ? pgno + n : pgno; w > r; --w)
+ pnl[w] = MDBX_PNL_ASCENDING ? --fill : fill++;
+
+ return MDBX_SUCCESS;
+}
+
+static bool __hot mdbx_pnl_check(const MDBX_PNL pl, const pgno_t limit) {
+ assert(limit >= MIN_PAGENO && limit <= MAX_PAGENO + 1);
+ if (likely(MDBX_PNL_SIZE(pl))) {
+ assert(MDBX_PNL_LEAST(pl) >= MIN_PAGENO);
+ assert(MDBX_PNL_MOST(pl) < limit);
+ assert(MDBX_PNL_SIZE(pl) <= MDBX_PNL_MAX);
+ if (unlikely(MDBX_PNL_SIZE(pl) > MDBX_PNL_MAX * 3 / 2))
+ return false;
+ if (unlikely(MDBX_PNL_LEAST(pl) < MIN_PAGENO))
+ return false;
+ if (unlikely(MDBX_PNL_MOST(pl) >= limit))
+ return false;
+ for (const pgno_t *scan = &MDBX_PNL_LAST(pl); --scan > pl;) {
+ assert(MDBX_PNL_ORDERED(scan[0], scan[1]));
+ if (unlikely(!MDBX_PNL_ORDERED(scan[0], scan[1])))
+ return false;
+ }
+ }
+ return true;
+}
+
+static __inline bool mdbx_pnl_check4assert(const MDBX_PNL pl,
+ const pgno_t limit) {
+ if (unlikely(pl == nullptr))
+ return true;
+ assert(MDBX_PNL_ALLOCLEN(pl) >= MDBX_PNL_SIZE(pl));
+ if (unlikely(MDBX_PNL_ALLOCLEN(pl) < MDBX_PNL_SIZE(pl)))
+ return false;
+ return mdbx_pnl_check(pl, limit);
+}
+
+/* Merge an PNL onto an PNL. The destination PNL must be big enough */
+static void __hot mdbx_pnl_xmerge(MDBX_PNL dst, const MDBX_PNL src) {
+ assert(mdbx_pnl_check4assert(dst, MAX_PAGENO + 1));
+ assert(mdbx_pnl_check(src, MAX_PAGENO + 1));
+ const size_t total = MDBX_PNL_SIZE(dst) + MDBX_PNL_SIZE(src);
+ assert(MDBX_PNL_ALLOCLEN(dst) >= total);
+ pgno_t *w = dst + total;
+ pgno_t *d = dst + MDBX_PNL_SIZE(dst);
+ const pgno_t *s = src + MDBX_PNL_SIZE(src);
+ dst[0] = /* detent for scan below */ (MDBX_PNL_ASCENDING ? 0 : ~(pgno_t)0);
+ while (s > src) {
+ while (MDBX_PNL_ORDERED(*s, *d))
+ *w-- = *d--;
+ *w-- = *s--;
+ }
+ MDBX_PNL_SIZE(dst) = (pgno_t)total;
+ assert(mdbx_pnl_check4assert(dst, MAX_PAGENO + 1));
+}
+
+SORT_IMPL(pgno_sort, pgno_t, MDBX_PNL_ORDERED)
+static __hot void mdbx_pnl_sort(MDBX_PNL pnl) {
+ pgno_sort(MDBX_PNL_BEGIN(pnl), MDBX_PNL_END(pnl));
+ assert(mdbx_pnl_check(pnl, MAX_PAGENO + 1));
+}
+
+/* Search for an pgno in an PNL.
+ * Returns The index of the first item greater than or equal to pgno. */
+SEARCH_IMPL(pgno_bsearch, pgno_t, pgno_t, MDBX_PNL_ORDERED)
+
+static __hot unsigned mdbx_pnl_search(MDBX_PNL pnl, pgno_t id) {
+ assert(mdbx_pnl_check4assert(pnl, MAX_PAGENO + 1));
+ pgno_t *begin = MDBX_PNL_BEGIN(pnl);
+ pgno_t *it = pgno_bsearch(begin, MDBX_PNL_SIZE(pnl), id);
+ pgno_t *end = begin + MDBX_PNL_SIZE(pnl);
+ assert(it >= begin && it <= end);
+ if (it != begin)
+ assert(MDBX_PNL_ORDERED(it[-1], id));
+ if (it != end)
+ assert(!MDBX_PNL_ORDERED(it[0], id));
+ return (unsigned)(it - begin + 1);
+}
+
+static __hot unsigned mdbx_pnl_exist(MDBX_PNL pnl, pgno_t id) {
+ unsigned n = mdbx_pnl_search(pnl, id);
+ return (n <= MDBX_PNL_SIZE(pnl) && pnl[n] == id) ? n : 0;
+}
+
+/*----------------------------------------------------------------------------*/
+
+static __inline size_t txl2bytes(const size_t size) {
+ assert(size > 0 && size <= MDBX_TXL_MAX * 2);
+ size_t bytes = roundup_powerof2(MDBX_ASSUME_MALLOC_OVERHEAD +
+ sizeof(txnid_t) * (size + 2),
+ MDBX_TXL_GRANULATE * sizeof(txnid_t)) -
+ MDBX_ASSUME_MALLOC_OVERHEAD;
+ return bytes;
+}
+
+static __inline size_t bytes2txl(const size_t bytes) {
+ size_t size = bytes / sizeof(txnid_t);
+ assert(size > 2 && size <= MDBX_TXL_MAX * 2);
+ return size - 2;
+}
+
+static MDBX_TXL mdbx_txl_alloc(void) {
+ size_t bytes = txl2bytes(MDBX_TXL_INITIAL);
+ MDBX_TXL tl = mdbx_malloc(bytes);
+ if (likely(tl)) {
+#if __GLIBC_PREREQ(2, 12) || defined(__FreeBSD__) || defined(__OpenBSD__) || \
+ defined(malloc_usable_size)
+ bytes = malloc_usable_size(tl);
+#endif /* malloc_usable_size */
+ tl[0] = bytes2txl(bytes);
+ assert(tl[0] >= MDBX_TXL_INITIAL);
+ tl[1] = 0;
+ tl += 1;
+ }
+ return tl;
+}
+
+static void mdbx_txl_free(MDBX_TXL tl) {
+ if (likely(tl))
+ mdbx_free(tl - 1);
+}
+
+static int mdbx_txl_reserve(MDBX_TXL *ptl, const size_t wanna) {
+ const size_t allocated = (size_t)MDBX_PNL_ALLOCLEN(*ptl);
+ assert(MDBX_PNL_SIZE(*ptl) <= MDBX_TXL_MAX &&
+ MDBX_PNL_ALLOCLEN(*ptl) >= MDBX_PNL_SIZE(*ptl));
+ if (likely(allocated >= wanna))
+ return MDBX_SUCCESS;
+
+ if (unlikely(wanna > /* paranoia */ MDBX_TXL_MAX))
+ return MDBX_TXN_FULL;
+
+ const size_t size = (wanna + wanna - allocated < MDBX_TXL_MAX)
+ ? wanna + wanna - allocated
+ : MDBX_TXL_MAX;
+ size_t bytes = txl2bytes(size);
+ MDBX_TXL tl = mdbx_realloc(*ptl - 1, bytes);
+ if (likely(tl)) {
+#if __GLIBC_PREREQ(2, 12) || defined(__FreeBSD__) || defined(__OpenBSD__) || \
+ defined(malloc_usable_size)
+ bytes = malloc_usable_size(tl);
+#endif /* malloc_usable_size */
+ *tl = bytes2txl(bytes);
+ assert(*tl >= wanna);
+ *ptl = tl + 1;
+ return MDBX_SUCCESS;
+ }
+ return MDBX_ENOMEM;
+}
+
+static __inline int __must_check_result mdbx_txl_need(MDBX_TXL *ptl,
+ size_t num) {
+ assert(MDBX_PNL_SIZE(*ptl) <= MDBX_TXL_MAX &&
+ MDBX_PNL_ALLOCLEN(*ptl) >= MDBX_PNL_SIZE(*ptl));
+ assert(num <= MDBX_PNL_MAX);
+ const size_t wanna = (size_t)MDBX_PNL_SIZE(*ptl) + num;
+ return likely(MDBX_PNL_ALLOCLEN(*ptl) >= wanna)
+ ? MDBX_SUCCESS
+ : mdbx_txl_reserve(ptl, wanna);
+}
+
+static __inline void mdbx_txl_xappend(MDBX_TXL tl, txnid_t id) {
+ assert(MDBX_PNL_SIZE(tl) < MDBX_PNL_ALLOCLEN(tl));
+ MDBX_PNL_SIZE(tl) += 1;
+ MDBX_PNL_LAST(tl) = id;
+}
+
+#define TXNID_SORT_CMP(first, last) ((first) > (last))
+SORT_IMPL(txnid_sort, txnid_t, TXNID_SORT_CMP)
+static void mdbx_txl_sort(MDBX_TXL tl) {
+ txnid_sort(MDBX_PNL_BEGIN(tl), MDBX_PNL_END(tl));
+}
+
+static int __must_check_result mdbx_txl_append(MDBX_TXL *ptl, txnid_t id) {
+ if (unlikely(MDBX_PNL_SIZE(*ptl) == MDBX_PNL_ALLOCLEN(*ptl))) {
+ int rc = mdbx_txl_need(ptl, MDBX_TXL_GRANULATE);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+ }
+ mdbx_txl_xappend(*ptl, id);
+ return MDBX_SUCCESS;
+}
+
+/*----------------------------------------------------------------------------*/
+
+#define DP_SORT_CMP(first, last) ((first).pgno < (last).pgno)
+SORT_IMPL(dp_sort, MDBX_DP, DP_SORT_CMP)
+static __inline MDBX_DPL mdbx_dpl_sort(MDBX_DPL dl) {
+ assert(dl->length <= MDBX_DPL_TXNFULL);
+ assert(dl->sorted <= dl->length);
+ if (dl->sorted != dl->length) {
+ dl->sorted = dl->length;
+ dp_sort(dl + 1, dl + dl->length + 1);
+ }
+ return dl;
+}
+
+/* Returns the index of the first dirty-page whose pgno
+ * member is greater than or equal to id. */
+#define DP_SEARCH_CMP(dp, id) ((dp).pgno < (id))
+SEARCH_IMPL(dp_bsearch, MDBX_DP, pgno_t, DP_SEARCH_CMP)
+
+static unsigned __hot mdbx_dpl_search(MDBX_DPL dl, pgno_t pgno) {
+ if (dl->sorted < dl->length) {
+ /* unsorted tail case */
+#if MDBX_DEBUG
+ for (const MDBX_DP *ptr = dl + dl->sorted; --ptr > dl;) {
+ assert(ptr[0].pgno < ptr[1].pgno);
+ assert(ptr[0].pgno >= NUM_METAS);
+ }
+#endif
+
+ /* try linear search until the threshold */
+ if (dl->length - dl->sorted < SORT_THRESHOLD / 2) {
+ unsigned i = dl->length;
+ while (i - dl->sorted > 7) {
+ if (dl[i].pgno == pgno)
+ return i;
+ if (dl[i - 1].pgno == pgno)
+ return i - 1;
+ if (dl[i - 2].pgno == pgno)
+ return i - 2;
+ if (dl[i - 3].pgno == pgno)
+ return i - 3;
+ if (dl[i - 4].pgno == pgno)
+ return i - 4;
+ if (dl[i - 5].pgno == pgno)
+ return i - 5;
+ if (dl[i - 6].pgno == pgno)
+ return i - 6;
+ if (dl[i - 7].pgno == pgno)
+ return i - 7;
+ i -= 8;
+ }
+ while (i > dl->sorted) {
+ if (dl[i].pgno == pgno)
+ return i;
+ --i;
+ }
+
+ MDBX_DPL it = dp_bsearch(dl + 1, i, pgno);
+ return (unsigned)(it - dl);
+ }
+
+ /* sort a whole */
+ dl->sorted = dl->length;
+ dp_sort(dl + 1, dl + dl->length + 1);
+ }
+
+#if MDBX_DEBUG
+ for (const MDBX_DP *ptr = dl + dl->length; --ptr > dl;) {
+ assert(ptr[0].pgno < ptr[1].pgno);
+ assert(ptr[0].pgno >= NUM_METAS);
+ }
+#endif
+
+ MDBX_DPL it = dp_bsearch(dl + 1, dl->length, pgno);
+ return (unsigned)(it - dl);
+}
+
+static __inline MDBX_page *mdbx_dpl_find(MDBX_DPL dl, pgno_t pgno) {
+ const unsigned i = mdbx_dpl_search(dl, pgno);
+ assert((int)i > 0);
+ return (i <= dl->length && dl[i].pgno == pgno) ? dl[i].ptr : nullptr;
+}
+
+static __hot MDBX_page *mdbx_dpl_remove(MDBX_DPL dl, pgno_t prno) {
+ unsigned i = mdbx_dpl_search(dl, prno);
+ assert((int)i > 0);
+ MDBX_page *mp = nullptr;
+ if (i <= dl->length && dl[i].pgno == prno) {
+ dl->sorted -= dl->sorted >= i;
+ mp = dl[i].ptr;
+ while (i < dl->length) {
+ dl[i] = dl[i + 1];
+ ++i;
+ }
+ dl->length -= 1;
+ }
+ return mp;
+}
+
+static __inline int __must_check_result mdbx_dpl_append(MDBX_DPL dl,
+ pgno_t pgno,
+ MDBX_page *page) {
+ assert(dl->length <= MDBX_DPL_TXNFULL);
+#if MDBX_DEBUG
+ for (unsigned i = dl->length; i > 0; --i) {
+ assert(dl[i].pgno != pgno);
+ if (unlikely(dl[i].pgno == pgno))
+ return MDBX_PROBLEM;
+ }
+#endif
+
+ if (unlikely(dl->length == MDBX_DPL_TXNFULL))
+ return MDBX_TXN_FULL;
+
+ /* append page */
+ const unsigned n = dl->length + 1;
+ if (n == 1 || (dl->sorted >= dl->length && dl[n - 1].pgno < pgno))
+ dl->sorted = n;
+ dl->length = n;
+ dl[n].pgno = pgno;
+ dl[n].ptr = page;
+ return MDBX_SUCCESS;
+}
+
+static __inline void mdbx_dpl_clear(MDBX_DPL dl) {
+ dl->sorted = dl->length = 0;
+}
+
+/*----------------------------------------------------------------------------*/
+
+#ifndef MDBX_ALLOY
+uint8_t mdbx_runtime_flags = MDBX_RUNTIME_FLAGS_INIT;
+uint8_t mdbx_loglevel = MDBX_DEBUG;
+MDBX_debug_func *mdbx_debug_logger;
+#endif /* MDBX_ALLOY */
+
+static bool mdbx_refund(MDBX_txn *txn);
+static __must_check_result int mdbx_page_retire(MDBX_cursor *mc, MDBX_page *mp);
+static __must_check_result int mdbx_page_loose(MDBX_txn *txn, MDBX_page *mp);
+static int mdbx_page_alloc(MDBX_cursor *mc, unsigned num, MDBX_page **mp,
+ int flags);
+static int mdbx_page_new(MDBX_cursor *mc, uint32_t flags, unsigned num,
+ MDBX_page **mp);
+static int mdbx_page_touch(MDBX_cursor *mc);
+static int mdbx_cursor_touch(MDBX_cursor *mc);
+
+#define MDBX_END_NAMES \
+ { \
+ "committed", "empty-commit", "abort", "reset", "reset-tmp", "fail-begin", \
+ "fail-beginchild" \
+ }
+enum {
+ /* mdbx_txn_end operation number, for logging */
+ MDBX_END_COMMITTED,
+ MDBX_END_EMPTY_COMMIT,
+ MDBX_END_ABORT,
+ MDBX_END_RESET,
+ MDBX_END_RESET_TMP,
+ MDBX_END_FAIL_BEGIN,
+ MDBX_END_FAIL_BEGINCHILD
+};
+#define MDBX_END_OPMASK 0x0F /* mask for mdbx_txn_end() operation number */
+#define MDBX_END_UPDATE 0x10 /* update env state (DBIs) */
+#define MDBX_END_FREE 0x20 /* free txn unless it is MDBX_env.me_txn0 */
+#define MDBX_END_EOTDONE 0x40 /* txn's cursors already closed */
+#define MDBX_END_SLOT 0x80 /* release any reader slot if MDBX_NOTLS */
+static int mdbx_txn_end(MDBX_txn *txn, unsigned mode);
+
+static int __must_check_result mdbx_page_get(MDBX_cursor *mc, pgno_t pgno,
+ MDBX_page **mp, int *lvl);
+static int __must_check_result mdbx_page_search_root(MDBX_cursor *mc,
+ MDBX_val *key, int modify);
+
+#define MDBX_PS_MODIFY 1
+#define MDBX_PS_ROOTONLY 2
+#define MDBX_PS_FIRST 4
+#define MDBX_PS_LAST 8
+static int __must_check_result mdbx_page_search(MDBX_cursor *mc, MDBX_val *key,
+ int flags);
+static int __must_check_result mdbx_page_merge(MDBX_cursor *csrc,
+ MDBX_cursor *cdst);
+static int __must_check_result mdbx_page_flush(MDBX_txn *txn,
+ const unsigned keep);
+
+#define MDBX_SPLIT_REPLACE MDBX_APPENDDUP /* newkey is not new */
+static int __must_check_result mdbx_page_split(MDBX_cursor *mc,
+ const MDBX_val *newkey,
+ MDBX_val *newdata,
+ pgno_t newpgno, unsigned nflags);
+
+static int __must_check_result mdbx_read_header(MDBX_env *env, MDBX_meta *meta,
+ uint64_t *filesize);
+static int __must_check_result mdbx_sync_locked(MDBX_env *env, unsigned flags,
+ MDBX_meta *const pending);
+static int mdbx_env_close0(MDBX_env *env);
+
+static MDBX_node *mdbx_node_search(MDBX_cursor *mc, MDBX_val *key, int *exactp);
+
+static int __must_check_result mdbx_node_add_branch(MDBX_cursor *mc,
+ unsigned indx,
+ const MDBX_val *key,
+ pgno_t pgno);
+static int __must_check_result mdbx_node_add_leaf(MDBX_cursor *mc,
+ unsigned indx,
+ const MDBX_val *key,
+ MDBX_val *data,
+ unsigned flags);
+static int __must_check_result mdbx_node_add_leaf2(MDBX_cursor *mc,
+ unsigned indx,
+ const MDBX_val *key);
+
+static void mdbx_node_del(MDBX_cursor *mc, size_t ksize);
+static void mdbx_node_shrink(MDBX_page *mp, unsigned indx);
+static int __must_check_result mdbx_node_move(MDBX_cursor *csrc,
+ MDBX_cursor *cdst, int fromleft);
+static int __must_check_result mdbx_node_read(MDBX_cursor *mc, MDBX_node *leaf,
+ MDBX_val *data);
+static int __must_check_result mdbx_rebalance(MDBX_cursor *mc);
+static int __must_check_result mdbx_update_key(MDBX_cursor *mc,
+ const MDBX_val *key);
+
+static void mdbx_cursor_pop(MDBX_cursor *mc);
+static int __must_check_result mdbx_cursor_push(MDBX_cursor *mc, MDBX_page *mp);
+
+static int __must_check_result mdbx_audit_ex(MDBX_txn *txn,
+ unsigned retired_stored,
+ bool dont_filter_gc);
+static __maybe_unused __inline int __must_check_result
+mdbx_audit(MDBX_txn *txn) {
+ return mdbx_audit_ex(txn, 0, (txn->mt_flags & MDBX_RDONLY) != 0);
+}
+
+static int __must_check_result mdbx_page_check(MDBX_env *env,
+ const MDBX_page *const mp,
+ bool maybe_unfinished);
+static int __must_check_result mdbx_cursor_check(MDBX_cursor *mc, bool pending);
+static int __must_check_result mdbx_cursor_del0(MDBX_cursor *mc);
+static int __must_check_result mdbx_del0(MDBX_txn *txn, MDBX_dbi dbi,
+ MDBX_val *key, MDBX_val *data,
+ unsigned flags);
+static int __must_check_result mdbx_cursor_sibling(MDBX_cursor *mc,
+ int move_right);
+static int __must_check_result mdbx_cursor_next(MDBX_cursor *mc, MDBX_val *key,
+ MDBX_val *data,
+ MDBX_cursor_op op);
+static int __must_check_result mdbx_cursor_prev(MDBX_cursor *mc, MDBX_val *key,
+ MDBX_val *data,
+ MDBX_cursor_op op);
+static int __must_check_result mdbx_cursor_set(MDBX_cursor *mc, MDBX_val *key,
+ MDBX_val *data,
+ MDBX_cursor_op op, int *exactp);
+static int __must_check_result mdbx_cursor_first(MDBX_cursor *mc, MDBX_val *key,
+ MDBX_val *data);
+static int __must_check_result mdbx_cursor_last(MDBX_cursor *mc, MDBX_val *key,
+ MDBX_val *data);
+
+static int __must_check_result mdbx_cursor_init(MDBX_cursor *mc, MDBX_txn *txn,
+ MDBX_dbi dbi);
+static int __must_check_result mdbx_xcursor_init0(MDBX_cursor *mc);
+static int __must_check_result mdbx_xcursor_init1(MDBX_cursor *mc,
+ MDBX_node *node);
+static int __must_check_result mdbx_xcursor_init2(MDBX_cursor *mc,
+ MDBX_xcursor *src_mx,
+ int force);
+static void mdbx_cursor_copy(const MDBX_cursor *csrc, MDBX_cursor *cdst);
+
+static int __must_check_result mdbx_drop0(MDBX_cursor *mc, int subs);
+static int __must_check_result mdbx_fetch_sdb(MDBX_txn *txn, MDBX_dbi dbi);
+
+static MDBX_cmp_func mdbx_cmp_memn, mdbx_cmp_memnr, mdbx_cmp_int_align4,
+ mdbx_cmp_int_align2, mdbx_cmp_int_unaligned;
+
+static const char *__mdbx_strerr(int errnum) {
+ /* Table of descriptions for MDBX errors */
+ static const char *const tbl[] = {
+ "MDBX_KEYEXIST: Key/data pair already exists",
+ "MDBX_NOTFOUND: No matching key/data pair found",
+ "MDBX_PAGE_NOTFOUND: Requested page not found",
+ "MDBX_CORRUPTED: Database is corrupted",
+ "MDBX_PANIC: Environment had fatal error",
+ "MDBX_VERSION_MISMATCH: DB version mismatch libmdbx",
+ "MDBX_INVALID: File is not an MDBX file",
+ "MDBX_MAP_FULL: Environment mapsize limit reached",
+ "MDBX_DBS_FULL: Too may DBI (maxdbs reached)",
+ "MDBX_READERS_FULL: Too many readers (maxreaders reached)",
+ NULL /* MDBX_TLS_FULL (-30789): unused in MDBX */,
+ "MDBX_TXN_FULL: Transaction has too many dirty pages, "
+ "i.e transaction too big",
+ "MDBX_CURSOR_FULL: Internal error - cursor stack limit reached",
+ "MDBX_PAGE_FULL: Internal error - page has no more space",
+ "MDBX_MAP_RESIZED: Database contents grew beyond environment mapsize",
+ "MDBX_INCOMPATIBLE: Operation and DB incompatible, or DB flags changed",
+ "MDBX_BAD_RSLOT: Invalid reuse of reader locktable slot",
+ "MDBX_BAD_TXN: Transaction must abort, has a child, or is invalid",
+ "MDBX_BAD_VALSIZE: Unsupported size of key/DB name/data, or wrong "
+ "DUPFIXED size",
+ "MDBX_BAD_DBI: The specified DBI handle was closed/changed unexpectedly",
+ "MDBX_PROBLEM: Unexpected problem - txn should abort",
+ "MDBX_BUSY: Another write transaction is running or "
+ "environment is already used while opening with MDBX_EXCLUSIVE flag",
+ };
+
+ if (errnum >= MDBX_KEYEXIST && errnum <= MDBX_LAST_ERRCODE) {
+ int i = errnum - MDBX_KEYEXIST;
+ return tbl[i];
+ }
+
+ switch (errnum) {
+ case MDBX_SUCCESS:
+ return "MDBX_SUCCESS: Successful";
+ case MDBX_EMULTIVAL:
+ return "MDBX_EMULTIVAL: Unable to update multi-value for the given key";
+ case MDBX_EBADSIGN:
+ return "MDBX_EBADSIGN: Wrong signature of a runtime object(s)";
+ case MDBX_WANNA_RECOVERY:
+ return "MDBX_WANNA_RECOVERY: Database should be recovered, but this could "
+ "NOT be done in a read-only mode";
+ case MDBX_EKEYMISMATCH:
+ return "MDBX_EKEYMISMATCH: The given key value is mismatched to the "
+ "current cursor position";
+ case MDBX_TOO_LARGE:
+ return "MDBX_TOO_LARGE: Database is too large for current system, "
+ "e.g. could NOT be mapped into RAM";
+ case MDBX_THREAD_MISMATCH:
+ return "MDBX_THREAD_MISMATCH: A thread has attempted to use a not "
+ "owned object, e.g. a transaction that started by another thread";
+ default:
+ return NULL;
+ }
+}
+
+const char *__cold mdbx_strerror_r(int errnum, char *buf, size_t buflen) {
+ const char *msg = __mdbx_strerr(errnum);
+ if (!msg && buflen > 0 && buflen < INT_MAX) {
+#if defined(_WIN32) || defined(_WIN64)
+ const DWORD size = FormatMessageA(
+ FORMAT_MESSAGE_FROM_SYSTEM | FORMAT_MESSAGE_IGNORE_INSERTS, NULL,
+ errnum, MAKELANGID(LANG_NEUTRAL, SUBLANG_DEFAULT), buf, (DWORD)buflen,
+ NULL);
+ return size ? buf : NULL;
+#elif defined(_GNU_SOURCE) && defined(__GLIBC__)
+ /* GNU-specific */
+ if (errnum > 0)
+ msg = strerror_r(errnum, buf, buflen);
+#elif (_POSIX_C_SOURCE >= 200112L || _XOPEN_SOURCE >= 600)
+ /* XSI-compliant */
+ if (errnum > 0 && strerror_r(errnum, buf, buflen) == 0)
+ msg = buf;
+#else
+ if (errnum > 0) {
+ msg = strerror(errnum);
+ if (msg) {
+ strncpy(buf, msg, buflen);
+ msg = buf;
+ }
+ }
+#endif
+ if (!msg) {
+ (void)snprintf(buf, buflen, "error %d", errnum);
+ msg = buf;
+ }
+ buf[buflen - 1] = '\0';
+ }
+ return msg;
+}
+
+const char *__cold mdbx_strerror(int errnum) {
+#if defined(_WIN32) || defined(_WIN64)
+ static char buf[1024];
+ return mdbx_strerror_r(errnum, buf, sizeof(buf));
+#else
+ const char *msg = __mdbx_strerr(errnum);
+ if (!msg) {
+ if (errnum > 0)
+ msg = strerror(errnum);
+ if (!msg) {
+ static char buf[32];
+ (void)snprintf(buf, sizeof(buf) - 1, "error %d", errnum);
+ msg = buf;
+ }
+ }
+ return msg;
+#endif
+}
+
+#if defined(_WIN32) || defined(_WIN64) /* Bit of madness for Windows */
+const char *mdbx_strerror_r_ANSI2OEM(int errnum, char *buf, size_t buflen) {
+ const char *msg = __mdbx_strerr(errnum);
+ if (!msg && buflen > 0 && buflen < INT_MAX) {
+ const DWORD size = FormatMessageA(
+ FORMAT_MESSAGE_FROM_SYSTEM | FORMAT_MESSAGE_IGNORE_INSERTS, NULL,
+ errnum, MAKELANGID(LANG_NEUTRAL, SUBLANG_DEFAULT), buf, (DWORD)buflen,
+ NULL);
+ if (size && CharToOemBuffA(buf, buf, size))
+ msg = buf;
+ }
+ return msg;
+}
+
+const char *mdbx_strerror_ANSI2OEM(int errnum) {
+ static char buf[1024];
+ return mdbx_strerror_r_ANSI2OEM(errnum, buf, sizeof(buf));
+}
+#endif /* Bit of madness for Windows */
+
+static txnid_t mdbx_oomkick(MDBX_env *env, const txnid_t laggard);
+
+void __cold mdbx_debug_log(int level, const char *function, int line,
+ const char *fmt, ...) {
+ va_list args;
+
+ va_start(args, fmt);
+ if (mdbx_debug_logger)
+ mdbx_debug_logger(level, function, line, fmt, args);
+ else {
+#if defined(_WIN32) || defined(_WIN64)
+ if (IsDebuggerPresent()) {
+ int prefix_len = 0;
+ char *prefix = nullptr;
+ if (function && line > 0)
+ prefix_len = mdbx_asprintf(&prefix, "%s:%d ", function, line);
+ else if (function)
+ prefix_len = mdbx_asprintf(&prefix, "%s: ", function);
+ else if (line > 0)
+ prefix_len = mdbx_asprintf(&prefix, "%d: ", line);
+ if (prefix_len > 0 && prefix) {
+ OutputDebugStringA(prefix);
+ mdbx_free(prefix);
+ }
+ char *msg = nullptr;
+ int msg_len = mdbx_vasprintf(&msg, fmt, args);
+ if (msg_len > 0 && msg) {
+ OutputDebugStringA(msg);
+ mdbx_free(msg);
+ }
+ }
+#else
+ if (function && line > 0)
+ fprintf(stderr, "%s:%d ", function, line);
+ else if (function)
+ fprintf(stderr, "%s: ", function);
+ else if (line > 0)
+ fprintf(stderr, "%d: ", line);
+ vfprintf(stderr, fmt, args);
+ fflush(stderr);
+#endif
+ }
+ va_end(args);
+}
+
+/* Dump a key in ascii or hexadecimal. */
+const char *mdbx_dump_val(const MDBX_val *key, char *const buf,
+ const size_t bufsize) {
+ if (!key)
+ return "";
+ if (!buf || bufsize < 4)
+ return nullptr;
+ if (!key->iov_len)
+ return "";
+
+ const uint8_t *const data = key->iov_base;
+ bool is_ascii = true;
+ unsigned i;
+ for (i = 0; is_ascii && i < key->iov_len; i++)
+ if (data[i] < ' ' || data[i] > 127)
+ is_ascii = false;
+
+ if (is_ascii) {
+ int len =
+ snprintf(buf, bufsize, "%.*s",
+ (key->iov_len > INT_MAX) ? INT_MAX : (int)key->iov_len, data);
+ assert(len > 0 && (unsigned)len < bufsize);
+ (void)len;
+ } else {
+ char *const detent = buf + bufsize - 2;
+ char *ptr = buf;
+ *ptr++ = '<';
+ for (i = 0; i < key->iov_len; i++) {
+ const ptrdiff_t left = detent - ptr;
+ assert(left > 0);
+ int len = snprintf(ptr, left, "%02x", data[i]);
+ if (len < 0 || len >= left)
+ break;
+ ptr += len;
+ }
+ if (ptr < detent) {
+ ptr[0] = '>';
+ ptr[1] = '\0';
+ }
+ }
+ return buf;
+}
+
+/*------------------------------------------------------------------------------
+ LY: debug stuff */
+
+static const char *mdbx_leafnode_type(MDBX_node *n) {
+ static const char *const tp[2][2] = {{"", ": DB"},
+ {": sub-page", ": sub-DB"}};
+ return F_ISSET(node_flags(n), F_BIGDATA)
+ ? ": overflow page"
+ : tp[F_ISSET(node_flags(n), F_DUPDATA)]
+ [F_ISSET(node_flags(n), F_SUBDATA)];
+}
+
+/* Display all the keys in the page. */
+static __maybe_unused void mdbx_page_list(MDBX_page *mp) {
+ pgno_t pgno = mp->mp_pgno;
+ const char *type, *state = IS_DIRTY(mp) ? ", dirty" : "";
+ MDBX_node *node;
+ unsigned i, nkeys, nsize, total = 0;
+ MDBX_val key;
+ DKBUF;
+
+ switch (mp->mp_flags &
+ (P_BRANCH | P_LEAF | P_LEAF2 | P_META | P_OVERFLOW | P_SUBP)) {
+ case P_BRANCH:
+ type = "Branch page";
+ break;
+ case P_LEAF:
+ type = "Leaf page";
+ break;
+ case P_LEAF | P_SUBP:
+ type = "Leaf sub-page";
+ break;
+ case P_LEAF | P_LEAF2:
+ type = "Leaf2 page";
+ break;
+ case P_LEAF | P_LEAF2 | P_SUBP:
+ type = "Leaf2 sub-page";
+ break;
+ case P_OVERFLOW:
+ mdbx_verbose("Overflow page %" PRIaPGNO " pages %u%s\n", pgno, mp->mp_pages,
+ state);
+ return;
+ case P_META:
+ mdbx_verbose("Meta-page %" PRIaPGNO " txnid %" PRIu64 "\n", pgno,
+ page_meta(mp)->mm_txnid_a.inconsistent);
+ return;
+ default:
+ mdbx_verbose("Bad page %" PRIaPGNO " flags 0x%X\n", pgno, mp->mp_flags);
+ return;
+ }
+
+ nkeys = page_numkeys(mp);
+ mdbx_verbose("%s %" PRIaPGNO " numkeys %u%s\n", type, pgno, nkeys, state);
+
+ for (i = 0; i < nkeys; i++) {
+ if (IS_LEAF2(mp)) { /* LEAF2 pages have no mp_ptrs[] or node headers */
+ key.iov_len = nsize = mp->mp_leaf2_ksize;
+ key.iov_base = page_leaf2key(mp, i, nsize);
+ total += nsize;
+ mdbx_verbose("key %u: nsize %u, %s\n", i, nsize, DKEY(&key));
+ continue;
+ }
+ node = page_node(mp, i);
+ key.iov_len = node_ks(node);
+ key.iov_base = node->mn_data;
+ nsize = (unsigned)(NODESIZE + key.iov_len);
+ if (IS_BRANCH(mp)) {
+ mdbx_verbose("key %u: page %" PRIaPGNO ", %s\n", i, node_pgno(node),
+ DKEY(&key));
+ total += nsize;
+ } else {
+ if (F_ISSET(node_flags(node), F_BIGDATA))
+ nsize += sizeof(pgno_t);
+ else
+ nsize += (unsigned)node_ds(node);
+ total += nsize;
+ nsize += sizeof(indx_t);
+ mdbx_verbose("key %u: nsize %u, %s%s\n", i, nsize, DKEY(&key),
+ mdbx_leafnode_type(node));
+ }
+ total = EVEN(total);
+ }
+ mdbx_verbose("Total: header %u + contents %u + unused %u\n",
+ IS_LEAF2(mp) ? PAGEHDRSZ : PAGEHDRSZ + mp->mp_lower, total,
+ page_room(mp));
+}
+
+/*----------------------------------------------------------------------------*/
+
+/* Check if there is an inited xcursor, so XCURSOR_REFRESH() is proper */
+#define XCURSOR_INITED(mc) \
+ ((mc)->mc_xcursor && ((mc)->mc_xcursor->mx_cursor.mc_flags & C_INITIALIZED))
+
+/* Update sub-page pointer, if any, in mc->mc_xcursor.
+ * Needed when the node which contains the sub-page may have moved.
+ * Called with mp = mc->mc_pg[mc->mc_top], ki = mc->mc_ki[mc->mc_top]. */
+#define XCURSOR_REFRESH(mc, mp, ki) \
+ do { \
+ MDBX_page *xr_pg = (mp); \
+ MDBX_node *xr_node = page_node(xr_pg, ki); \
+ if ((node_flags(xr_node) & (F_DUPDATA | F_SUBDATA)) == F_DUPDATA) \
+ (mc)->mc_xcursor->mx_cursor.mc_pg[0] = node_data(xr_node); \
+ } while (0)
+
+/* Perform act while tracking temporary cursor mn */
+#define WITH_CURSOR_TRACKING(mn, act) \
+ do { \
+ mdbx_cassert(&(mn), \
+ mn.mc_txn->mt_cursors != NULL /* must be not rdonly txt */); \
+ MDBX_cursor mc_dummy, **tp = &(mn).mc_txn->mt_cursors[mn.mc_dbi]; \
+ MDBX_cursor *tracked = &(mn); \
+ if ((mn).mc_flags & C_SUB) { \
+ mc_dummy.mc_flags = C_INITIALIZED; \
+ mc_dummy.mc_xcursor = (MDBX_xcursor *)&(mn); \
+ tracked = &mc_dummy; \
+ } \
+ tracked->mc_next = *tp; \
+ *tp = tracked; \
+ { act; } \
+ *tp = tracked->mc_next; \
+ } while (0)
+
+int mdbx_cmp(MDBX_txn *txn, MDBX_dbi dbi, const MDBX_val *a,
+ const MDBX_val *b) {
+ mdbx_assert(NULL, txn->mt_signature == MDBX_MT_SIGNATURE);
+ return txn->mt_dbxs[dbi].md_cmp(a, b);
+}
+
+int mdbx_dcmp(MDBX_txn *txn, MDBX_dbi dbi, const MDBX_val *a,
+ const MDBX_val *b) {
+ mdbx_assert(NULL, txn->mt_signature == MDBX_MT_SIGNATURE);
+ return txn->mt_dbxs[dbi].md_dcmp(a, b);
+}
+
+/* Allocate memory for a page.
+ * Re-use old malloc'd pages first for singletons, otherwise just malloc.
+ * Set MDBX_TXN_ERROR on failure. */
+static MDBX_page *mdbx_page_malloc(MDBX_txn *txn, unsigned num) {
+ MDBX_env *env = txn->mt_env;
+ MDBX_page *np = env->me_dpages;
+ size_t size = env->me_psize;
+ if (likely(num == 1 && np)) {
+ ASAN_UNPOISON_MEMORY_REGION(np, size);
+ VALGRIND_MEMPOOL_ALLOC(env, np, size);
+ VALGRIND_MAKE_MEM_DEFINED(&np->mp_next, sizeof(np->mp_next));
+ env->me_dpages = np->mp_next;
+ } else {
+ size = pgno2bytes(env, num);
+ np = mdbx_malloc(size);
+ if (unlikely(!np)) {
+ txn->mt_flags |= MDBX_TXN_ERROR;
+ return np;
+ }
+ VALGRIND_MEMPOOL_ALLOC(env, np, size);
+ }
+
+ if ((env->me_flags & MDBX_NOMEMINIT) == 0) {
+ /* For a single page alloc, we init everything after the page header.
+ * For multi-page, we init the final page; if the caller needed that
+ * many pages they will be filling in at least up to the last page. */
+ size_t skip = PAGEHDRSZ;
+ if (num > 1)
+ skip += pgno2bytes(env, num - 1);
+ memset((char *)np + skip, 0, size - skip);
+ }
+#if MDBX_DEBUG
+ np->mp_pgno = 0;
+#endif
+ VALGRIND_MAKE_MEM_UNDEFINED(np, size);
+ np->mp_flags = 0;
+ np->mp_pages = num;
+ return np;
+}
+
+/* Free a dirty page */
+static void mdbx_dpage_free(MDBX_env *env, MDBX_page *dp, unsigned pages) {
+#if MDBX_DEBUG
+ dp->mp_pgno = MAX_PAGENO + 1;
+#endif
+ if (pages == 1) {
+ dp->mp_next = env->me_dpages;
+ VALGRIND_MEMPOOL_FREE(env, dp);
+ env->me_dpages = dp;
+ } else {
+ /* large pages just get freed directly */
+ VALGRIND_MEMPOOL_FREE(env, dp);
+ mdbx_free(dp);
+ }
+}
+
+/* Return all dirty pages to dpage list */
+static void mdbx_dlist_free(MDBX_txn *txn) {
+ MDBX_env *env = txn->mt_env;
+ const MDBX_DPL dl = txn->tw.dirtylist;
+ const size_t n = dl->length;
+
+ for (size_t i = 1; i <= n; i++) {
+ MDBX_page *dp = dl[i].ptr;
+ mdbx_dpage_free(env, dp, IS_OVERFLOW(dp) ? dp->mp_pages : 1);
+ }
+
+ mdbx_dpl_clear(dl);
+}
+
+static __inline MDBX_db *mdbx_outer_db(MDBX_cursor *mc) {
+ mdbx_cassert(mc, (mc->mc_flags & C_SUB) != 0);
+ MDBX_xcursor *mx = container_of(mc->mc_db, MDBX_xcursor, mx_db);
+ MDBX_cursor_couple *couple = container_of(mx, MDBX_cursor_couple, inner);
+ mdbx_cassert(mc, mc->mc_db == &couple->outer.mc_xcursor->mx_db);
+ mdbx_cassert(mc, mc->mc_dbx == &couple->outer.mc_xcursor->mx_dbx);
+ return couple->outer.mc_db;
+}
+
+static __cold __maybe_unused bool mdbx_dirtylist_check(MDBX_txn *txn) {
+ unsigned loose = 0;
+ for (unsigned i = txn->tw.dirtylist->length; i > 0; --i) {
+ const MDBX_page *const dp = txn->tw.dirtylist[i].ptr;
+ if (!dp)
+ continue;
+ mdbx_tassert(txn, dp->mp_pgno == txn->tw.dirtylist[i].pgno);
+ if (unlikely(dp->mp_pgno != txn->tw.dirtylist[i].pgno))
+ return false;
+
+ mdbx_tassert(txn, dp->mp_flags & P_DIRTY);
+ if (unlikely((dp->mp_flags & P_DIRTY) == 0))
+ return false;
+ if (dp->mp_flags & P_LOOSE) {
+ mdbx_tassert(txn, dp->mp_flags == (P_LOOSE | P_DIRTY));
+ if (unlikely(dp->mp_flags != (P_LOOSE | P_DIRTY)))
+ return false;
+ loose += 1;
+ }
+
+ const unsigned num = IS_OVERFLOW(dp) ? dp->mp_pages : 1;
+ mdbx_tassert(txn, txn->mt_next_pgno >= dp->mp_pgno + num);
+ if (unlikely(txn->mt_next_pgno < dp->mp_pgno + num))
+ return false;
+
+ if (i < txn->tw.dirtylist->sorted) {
+ mdbx_tassert(txn, txn->tw.dirtylist[i + 1].pgno >= dp->mp_pgno + num);
+ if (unlikely(txn->tw.dirtylist[i + 1].pgno < dp->mp_pgno + num))
+ return false;
+ }
+
+ const unsigned rpa = mdbx_pnl_search(txn->tw.reclaimed_pglist, dp->mp_pgno);
+ mdbx_tassert(txn, rpa > MDBX_PNL_SIZE(txn->tw.reclaimed_pglist) ||
+ txn->tw.reclaimed_pglist[rpa] != dp->mp_pgno);
+ if (rpa <= MDBX_PNL_SIZE(txn->tw.reclaimed_pglist) &&
+ unlikely(txn->tw.reclaimed_pglist[rpa] == dp->mp_pgno))
+ return false;
+ if (num > 1) {
+ const unsigned rpb =
+ mdbx_pnl_search(txn->tw.reclaimed_pglist, dp->mp_pgno + num - 1);
+ mdbx_tassert(txn, rpa == rpb);
+ if (unlikely(rpa != rpb))
+ return false;
+ }
+ }
+
+ mdbx_tassert(txn, loose == txn->tw.loose_count);
+ if (unlikely(loose != txn->tw.loose_count))
+ return false;
+
+ if (txn->tw.dirtylist->length - txn->tw.dirtylist->sorted <
+ SORT_THRESHOLD / 2) {
+ for (unsigned i = 1; i <= MDBX_PNL_SIZE(txn->tw.retired_pages); ++i) {
+ const MDBX_page *const dp =
+ mdbx_dpl_find(txn->tw.dirtylist, txn->tw.retired_pages[i]);
+ mdbx_tassert(txn, !dp);
+ if (unlikely(dp))
+ return false;
+ }
+ }
+
+ return true;
+}
+
+static void mdbx_refund_reclaimed(MDBX_txn *txn) {
+ /* Scanning in descend order */
+ pgno_t next_pgno = txn->mt_next_pgno;
+ const MDBX_PNL pnl = txn->tw.reclaimed_pglist;
+ mdbx_tassert(txn, MDBX_PNL_SIZE(pnl) && MDBX_PNL_MOST(pnl) == next_pgno - 1);
+#if MDBX_PNL_ASCENDING
+ unsigned i = MDBX_PNL_SIZE(pnl);
+ mdbx_tassert(txn, pnl[i] == next_pgno - 1);
+ while (--next_pgno, --i > 0 && pnl[i] == next_pgno - 1)
+ ;
+ MDBX_PNL_SIZE(pnl) = i;
+#else
+ unsigned i = 1;
+ mdbx_tassert(txn, pnl[i] == next_pgno - 1);
+ unsigned len = MDBX_PNL_SIZE(pnl);
+ while (--next_pgno, ++i <= len && pnl[i] == next_pgno - 1)
+ ;
+ MDBX_PNL_SIZE(pnl) = len -= i - 1;
+ for (unsigned move = 0; move < len; ++move)
+ pnl[1 + move] = pnl[i + move];
+#endif
+ mdbx_verbose("refunded %" PRIaPGNO " pages: %" PRIaPGNO " -> %" PRIaPGNO,
+ txn->mt_next_pgno - next_pgno, txn->mt_next_pgno, next_pgno);
+ txn->mt_next_pgno = next_pgno;
+ mdbx_tassert(
+ txn, mdbx_pnl_check4assert(txn->tw.reclaimed_pglist, txn->mt_next_pgno));
+}
+
+static void mdbx_refund_loose(MDBX_txn *txn) {
+ mdbx_tassert(txn, mdbx_dirtylist_check(txn));
+ mdbx_tassert(txn, txn->tw.loose_pages != nullptr);
+ mdbx_tassert(txn, txn->tw.loose_count > 0);
+
+ const MDBX_DPL dl = txn->tw.dirtylist;
+ mdbx_tassert(txn, dl->length >= txn->tw.loose_count);
+ mdbx_tassert(txn, txn->tw.spill_pages == nullptr ||
+ dl->length >= MDBX_PNL_SIZE(txn->tw.spill_pages));
+
+ pgno_t onstack[MDBX_CACHELINE_SIZE * 8 / sizeof(pgno_t)];
+ MDBX_PNL suitable = onstack;
+
+ if (dl->length - dl->sorted > txn->tw.loose_count) {
+ /* Dirty list is useless since unsorted. */
+ if (bytes2pnl(sizeof(onstack)) < txn->tw.loose_count) {
+ suitable = mdbx_pnl_alloc(txn->tw.loose_count);
+ if (unlikely(!suitable))
+ return /* this is not a reason for transaction fail */;
+ }
+
+ /* Collect loose-pages which may be refunded. */
+ mdbx_tassert(txn, txn->mt_next_pgno >= MIN_PAGENO + txn->tw.loose_count);
+ pgno_t most = MIN_PAGENO;
+ unsigned w = 0;
+ for (const MDBX_page *dp = txn->tw.loose_pages; dp; dp = dp->mp_next) {
+ mdbx_tassert(txn, dp->mp_flags == (P_LOOSE | P_DIRTY));
+ mdbx_tassert(txn, txn->mt_next_pgno > dp->mp_pgno);
+ if (likely(txn->mt_next_pgno - txn->tw.loose_count <= dp->mp_pgno)) {
+ mdbx_tassert(txn,
+ w < ((suitable == onstack) ? bytes2pnl(sizeof(onstack))
+ : MDBX_PNL_ALLOCLEN(suitable)));
+ suitable[++w] = dp->mp_pgno;
+ most = (dp->mp_pgno > most) ? dp->mp_pgno : most;
+ }
+ }
+
+ if (most + 1 == txn->mt_next_pgno) {
+ /* Sort suitable list and refund pages at the tail. */
+ MDBX_PNL_SIZE(suitable) = w;
+ mdbx_pnl_sort(suitable);
+
+ /* Scanning in descend order */
+ const int step = MDBX_PNL_ASCENDING ? -1 : 1;
+ const int begin = MDBX_PNL_ASCENDING ? MDBX_PNL_SIZE(suitable) : 1;
+ const int end = MDBX_PNL_ASCENDING ? 0 : MDBX_PNL_SIZE(suitable) + 1;
+ mdbx_tassert(txn, suitable[begin] >= suitable[end - step]);
+ mdbx_tassert(txn, most == suitable[begin]);
+
+ for (int i = begin + step; i != end; i += step) {
+ if (suitable[i] != most - 1)
+ break;
+ most -= 1;
+ }
+ const unsigned refunded = txn->mt_next_pgno - most;
+ mdbx_verbose("refund-sorted %u pages %" PRIaPGNO " -> %" PRIaPGNO,
+ refunded, most, txn->mt_next_pgno);
+ txn->tw.loose_count -= refunded;
+ txn->tw.dirtyroom += refunded;
+ txn->mt_next_pgno = most;
+
+ /* Filter-out dirty list */
+ unsigned r = 0;
+ w = 0;
+ if (dl->sorted) {
+ do {
+ if (dl[++r].pgno < most) {
+ if (++w != r)
+ dl[w] = dl[r];
+ }
+ } while (r < dl->sorted);
+ dl->sorted = w;
+ }
+ while (r < dl->length) {
+ if (dl[++r].pgno < most) {
+ if (++w != r)
+ dl[w] = dl[r];
+ }
+ }
+ dl->length = w;
+ mdbx_tassert(txn, txn->mt_parent ||
+ txn->tw.dirtyroom + txn->tw.dirtylist->length ==
+ MDBX_DPL_TXNFULL);
+ goto unlink_loose;
+ }
+ } else {
+ /* Dirtylist is mostly sorted, just refund loose pages at the end. */
+ mdbx_dpl_sort(dl);
+ mdbx_tassert(txn, dl->length < 2 || dl[1].pgno < dl[dl->length].pgno);
+ mdbx_tassert(txn, dl->sorted == dl->length);
+
+ /* Scan dirtylist tail-forward and cutoff suitable pages. */
+ while (dl->length && dl[dl->length].pgno == txn->mt_next_pgno - 1 &&
+ dl[dl->length].ptr->mp_flags == (P_LOOSE | P_DIRTY)) {
+ MDBX_page *dp = dl[dl->length].ptr;
+ mdbx_verbose("refund-unsorted page %" PRIaPGNO, dp->mp_pgno);
+ mdbx_tassert(txn, dp->mp_pgno == dl[dl->length].pgno);
+ dl->length -= 1;
+ }
+
+ if (dl->sorted != dl->length) {
+ const unsigned refunded = dl->sorted - dl->length;
+ dl->sorted = dl->length;
+ txn->tw.loose_count -= refunded;
+ txn->tw.dirtyroom += refunded;
+ txn->mt_next_pgno -= refunded;
+ mdbx_tassert(txn, txn->mt_parent ||
+ txn->tw.dirtyroom + txn->tw.dirtylist->length ==
+ MDBX_DPL_TXNFULL);
+
+ /* Filter-out loose chain & dispose refunded pages. */
+ unlink_loose:
+ for (MDBX_page **link = &txn->tw.loose_pages; *link;) {
+ MDBX_page *dp = *link;
+ mdbx_tassert(txn, dp->mp_flags == (P_LOOSE | P_DIRTY));
+ if (txn->mt_next_pgno > dp->mp_pgno) {
+ link = &dp->mp_next;
+ } else {
+ *link = dp->mp_next;
+ if ((txn->mt_flags & MDBX_WRITEMAP) == 0)
+ mdbx_dpage_free(txn->mt_env, dp, 1);
+ }
+ }
+ }
+ }
+
+ mdbx_tassert(txn, mdbx_dirtylist_check(txn));
+ mdbx_tassert(txn, txn->mt_parent ||
+ txn->tw.dirtyroom + txn->tw.dirtylist->length ==
+ MDBX_DPL_TXNFULL);
+ if (suitable != onstack)
+ mdbx_pnl_free(suitable);
+ txn->tw.loose_refund_wl = txn->mt_next_pgno;
+}
+
+static bool mdbx_refund(MDBX_txn *txn) {
+ const pgno_t before = txn->mt_next_pgno;
+
+ if (txn->tw.loose_pages && txn->tw.loose_refund_wl > txn->mt_next_pgno)
+ mdbx_refund_loose(txn);
+
+ while (true) {
+ if (MDBX_PNL_SIZE(txn->tw.reclaimed_pglist) == 0 ||
+ MDBX_PNL_MOST(txn->tw.reclaimed_pglist) != txn->mt_next_pgno - 1)
+ break;
+
+ mdbx_refund_reclaimed(txn);
+ if (!txn->tw.loose_pages || txn->tw.loose_refund_wl <= txn->mt_next_pgno)
+ break;
+
+ const pgno_t memo = txn->mt_next_pgno;
+ mdbx_refund_loose(txn);
+ if (memo == txn->mt_next_pgno)
+ break;
+ }
+
+ return before != txn->mt_next_pgno;
+}
+
+static __cold void mdbx_kill_page(MDBX_env *env, MDBX_page *mp, pgno_t pgno,
+ unsigned npages) {
+ mdbx_assert(env, pgno >= NUM_METAS && npages);
+ if (IS_DIRTY(mp) || (env->me_flags & MDBX_WRITEMAP)) {
+ const size_t bytes = pgno2bytes(env, npages);
+ memset(mp, 0, bytes);
+ mp->mp_pgno = pgno;
+ if ((env->me_flags & MDBX_WRITEMAP) == 0)
+ mdbx_pwrite(env->me_fd, mp, bytes, pgno2bytes(env, pgno));
+ } else {
+ struct iovec iov[MDBX_COMMIT_PAGES];
+ iov[0].iov_len = env->me_psize;
+ iov[0].iov_base = (char *)env->me_pbuf + env->me_psize;
+ size_t iov_off = pgno2bytes(env, pgno);
+ unsigned n = 1;
+ while (--npages) {
+ iov[n] = iov[0];
+ if (++n == MDBX_COMMIT_PAGES) {
+ mdbx_pwritev(env->me_fd, iov, MDBX_COMMIT_PAGES, iov_off,
+ pgno2bytes(env, MDBX_COMMIT_PAGES));
+ iov_off += pgno2bytes(env, MDBX_COMMIT_PAGES);
+ n = 0;
+ }
+ }
+ mdbx_pwritev(env->me_fd, iov, n, iov_off, pgno2bytes(env, n));
+ }
+}
+
+/* Retire, loosen or free a single page.
+ *
+ * Saves single pages to a list for future reuse
+ * in this same txn. It has been pulled from the GC
+ * and already resides on the dirty list, but has been
+ * deleted. Use these pages first before pulling again
+ * from the GC.
+ *
+ * If the page wasn't dirtied in this txn, just add it
+ * to this txn's free list. */
+
+static __hot int mdbx_page_loose(MDBX_txn *txn, MDBX_page *mp) {
+ const unsigned npages = IS_OVERFLOW(mp) ? mp->mp_pages : 1;
+ const pgno_t pgno = mp->mp_pgno;
+
+ if (txn->mt_parent) {
+ mdbx_tassert(txn, (txn->mt_env->me_flags & MDBX_WRITEMAP) == 0);
+ mdbx_tassert(txn, mp != pgno2page(txn->mt_env, pgno));
+ /* If txn has a parent, make sure the page is in our dirty list. */
+ MDBX_page *dp = mdbx_dpl_find(txn->tw.dirtylist, pgno);
+ /* TODO: use extended flag-mask to track parent's dirty-pages */
+ if (dp == nullptr) {
+ mp->mp_next = txn->tw.retired2parent_pages;
+ txn->tw.retired2parent_pages = mp;
+ txn->tw.retired2parent_count += npages;
+ return MDBX_SUCCESS;
+ }
+ if (unlikely(mp != dp)) { /* bad cursor? */
+ mdbx_error(
+ "wrong page 0x%p #%" PRIaPGNO " in the dirtylist, expecting %p",
+ __Wpedantic_format_voidptr(dp), pgno, __Wpedantic_format_voidptr(mp));
+ txn->mt_flags |= MDBX_TXN_ERROR;
+ return MDBX_PROBLEM;
+ }
+ /* ok, it's ours */
+ }
+
+ mdbx_debug("loosen page %" PRIaPGNO, pgno);
+ const bool is_dirty = IS_DIRTY(mp);
+ if (MDBX_DEBUG || unlikely((txn->mt_env->me_flags & MDBX_PAGEPERTURB) != 0)) {
+ mdbx_kill_page(txn->mt_env, mp, pgno, npages);
+ VALGRIND_MAKE_MEM_UNDEFINED(mp, PAGEHDRSZ);
+ }
+ VALGRIND_MAKE_MEM_NOACCESS(page_data(mp),
+ pgno2bytes(txn->mt_env, npages) - PAGEHDRSZ);
+ ASAN_POISON_MEMORY_REGION(page_data(mp),
+ pgno2bytes(txn->mt_env, npages) - PAGEHDRSZ);
+
+ if (unlikely(npages >
+ 1 /* overflow pages doesn't comes to the loose-list */)) {
+ if (is_dirty) {
+ /* Remove from dirty list */
+ MDBX_page *dp = mdbx_dpl_remove(txn->tw.dirtylist, pgno);
+ if (unlikely(dp != mp)) {
+ mdbx_error("not found page 0x%p #%" PRIaPGNO " in the dirtylist",
+ __Wpedantic_format_voidptr(mp), pgno);
+ txn->mt_flags |= MDBX_TXN_ERROR;
+ return MDBX_PROBLEM;
+ }
+ txn->tw.dirtyroom++;
+ mdbx_tassert(txn, txn->mt_parent ||
+ txn->tw.dirtyroom + txn->tw.dirtylist->length ==
+ MDBX_DPL_TXNFULL);
+ if ((txn->mt_flags & MDBX_WRITEMAP) == 0)
+ mdbx_dpage_free(txn->mt_env, mp, npages);
+ }
+
+ if (unlikely(pgno + npages == txn->mt_next_pgno)) {
+ txn->mt_next_pgno = pgno;
+ mdbx_refund(txn);
+ return MDBX_SUCCESS;
+ }
+
+ int rc = mdbx_pnl_insert_range(&txn->tw.reclaimed_pglist, pgno, npages);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+ mdbx_tassert(txn, mdbx_pnl_check4assert(txn->tw.reclaimed_pglist,
+ txn->mt_next_pgno));
+ return MDBX_SUCCESS;
+ }
+
+ mp->mp_flags = P_LOOSE | P_DIRTY;
+ mp->mp_next = txn->tw.loose_pages;
+ txn->tw.loose_pages = mp;
+ txn->tw.loose_count++;
+ if (unlikely(txn->mt_next_pgno == mp->mp_pgno + 1))
+ mdbx_refund(txn);
+
+ return MDBX_SUCCESS;
+}
+
+static __hot int mdbx_page_retire(MDBX_cursor *mc, MDBX_page *mp) {
+ const unsigned npages = IS_OVERFLOW(mp) ? mp->mp_pages : 1;
+ const pgno_t pgno = mp->mp_pgno;
+ MDBX_txn *const txn = mc->mc_txn;
+
+ if (unlikely(mc->mc_flags & C_SUB)) {
+ MDBX_db *outer = mdbx_outer_db(mc);
+ mdbx_cassert(mc, !IS_BRANCH(mp) || outer->md_branch_pages > 0);
+ outer->md_branch_pages -= IS_BRANCH(mp);
+ mdbx_cassert(mc, !IS_LEAF(mp) || outer->md_leaf_pages > 0);
+ outer->md_leaf_pages -= IS_LEAF(mp);
+ mdbx_cassert(mc, !IS_OVERFLOW(mp));
+ }
+ mdbx_cassert(mc, !IS_BRANCH(mp) || mc->mc_db->md_branch_pages > 0);
+ mc->mc_db->md_branch_pages -= IS_BRANCH(mp);
+ mdbx_cassert(mc, !IS_LEAF(mp) || mc->mc_db->md_leaf_pages > 0);
+ mc->mc_db->md_leaf_pages -= IS_LEAF(mp);
+ mdbx_cassert(mc, !IS_OVERFLOW(mp) || mc->mc_db->md_overflow_pages >= npages);
+ mc->mc_db->md_overflow_pages -= IS_OVERFLOW(mp) ? npages : 0;
+
+ if (IS_DIRTY(mp)) {
+ int rc = mdbx_page_loose(txn, mp);
+ if (unlikely(rc != MDBX_SUCCESS))
+ mc->mc_flags &= ~(C_INITIALIZED | C_EOF);
+ return rc;
+ }
+
+ if (txn->tw.spill_pages) {
+ const unsigned i = mdbx_pnl_exist(txn->tw.spill_pages, pgno << 1);
+ if (i) {
+ /* This page is no longer spilled */
+ mdbx_tassert(txn, i == MDBX_PNL_SIZE(txn->tw.spill_pages) ||
+ txn->tw.spill_pages[i + 1] >= (pgno + npages) << 1);
+ txn->tw.spill_pages[i] |= 1;
+ if (i == MDBX_PNL_SIZE(txn->tw.spill_pages))
+ MDBX_PNL_SIZE(txn->tw.spill_pages) -= 1;
+ int rc = mdbx_page_loose(txn, mp);
+ if (unlikely(rc != MDBX_SUCCESS))
+ mc->mc_flags &= ~(C_INITIALIZED | C_EOF);
+ return rc;
+ }
+ }
+
+ mdbx_tassert(txn, mp == pgno2page(txn->mt_env, pgno));
+ int rc = mdbx_pnl_append_range(&txn->tw.retired_pages, pgno, npages);
+ mdbx_tassert(txn, mdbx_dpl_find(txn->tw.dirtylist, pgno) == nullptr);
+ return rc;
+}
+
+static __must_check_result __inline int mdbx_retire_pgno(MDBX_cursor *mc,
+ const pgno_t pgno) {
+ MDBX_page *mp;
+ int rc = mdbx_page_get(mc, pgno, &mp, NULL);
+ if (likely(rc == MDBX_SUCCESS))
+ rc = mdbx_page_retire(mc, mp);
+ return rc;
+}
+
+/* Set or clear P_KEEP in dirty, non-overflow, non-sub pages watched by txn.
+ *
+ * [in] mc A cursor handle for the current operation.
+ * [in] pflags Flags of the pages to update:
+ * - P_DIRTY to set P_KEEP,
+ * - P_DIRTY|P_KEEP to clear it.
+ * [in] all No shortcuts. Needed except after a full mdbx_page_flush().
+ *
+ * Returns 0 on success, non-zero on failure. */
+static int mdbx_pages_xkeep(MDBX_cursor *mc, unsigned pflags, bool all) {
+ const unsigned Mask = P_SUBP | P_DIRTY | P_LOOSE | P_KEEP;
+ MDBX_txn *txn = mc->mc_txn;
+ MDBX_cursor *m3, *m0 = mc;
+ MDBX_xcursor *mx;
+ MDBX_page *dp, *mp;
+ unsigned i, j;
+ int rc = MDBX_SUCCESS;
+
+ /* Mark pages seen by cursors: First m0, then tracked cursors */
+ for (i = txn->mt_numdbs;;) {
+ if (mc->mc_flags & C_INITIALIZED) {
+ for (m3 = mc;; m3 = &mx->mx_cursor) {
+ mp = NULL;
+ for (j = 0; j < m3->mc_snum; j++) {
+ mp = m3->mc_pg[j];
+ if ((mp->mp_flags & Mask) == pflags)
+ mp->mp_flags ^= P_KEEP;
+ }
+ mx = m3->mc_xcursor;
+ /* Proceed to mx if it is at a sub-database */
+ if (!(mx && (mx->mx_cursor.mc_flags & C_INITIALIZED)))
+ break;
+ if (!(mp && IS_LEAF(mp)))
+ break;
+ if (!(node_flags(page_node(mp, m3->mc_ki[j - 1])) & F_SUBDATA))
+ break;
+ }
+ }
+ mc = mc->mc_next;
+ for (; !mc || mc == m0; mc = txn->mt_cursors[--i])
+ if (i == 0)
+ goto mark_done;
+ }
+
+mark_done:
+ if (all) {
+ /* Mark dirty root pages */
+ for (i = 0; i < txn->mt_numdbs; i++) {
+ if (txn->mt_dbflags[i] & DB_DIRTY) {
+ pgno_t pgno = txn->mt_dbs[i].md_root;
+ if (pgno == P_INVALID)
+ continue;
+ int level;
+ if (unlikely((rc = mdbx_page_get(m0, pgno, &dp, &level)) !=
+ MDBX_SUCCESS))
+ break;
+ if ((dp->mp_flags & Mask) == pflags && level <= 1)
+ dp->mp_flags ^= P_KEEP;
+ }
+ }
+ }
+
+ return rc;
+}
+
+/* Spill pages from the dirty list back to disk.
+ * This is intended to prevent running into MDBX_TXN_FULL situations,
+ * but note that they may still occur in a few cases:
+ *
+ * 1) our estimate of the txn size could be too small. Currently this
+ * seems unlikely, except with a large number of MDBX_MULTIPLE items.
+ *
+ * 2) child txns may run out of space if their parents dirtied a
+ * lot of pages and never spilled them. TODO: we probably should do
+ * a preemptive spill during mdbx_txn_begin() of a child txn, if
+ * the parent's dirtyroom is below a given threshold.
+ *
+ * Otherwise, if not using nested txns, it is expected that apps will
+ * not run into MDBX_TXN_FULL any more. The pages are flushed to disk
+ * the same way as for a txn commit, e.g. their P_DIRTY flag is cleared.
+ * If the txn never references them again, they can be left alone.
+ * If the txn only reads them, they can be used without any fuss.
+ * If the txn writes them again, they can be dirtied immediately without
+ * going thru all of the work of mdbx_page_touch(). Such references are
+ * handled by mdbx_page_unspill().
+ *
+ * Also note, we never spill DB root pages, nor pages of active cursors,
+ * because we'll need these back again soon anyway. And in nested txns,
+ * we can't spill a page in a child txn if it was already spilled in a
+ * parent txn. That would alter the parent txns' data even though
+ * the child hasn't committed yet, and we'd have no way to undo it if
+ * the child aborted.
+ *
+ * [in] mc cursor A cursor handle identifying the transaction and
+ * database for which we are checking space.
+ * [in] key For a put operation, the key being stored.
+ * [in] data For a put operation, the data being stored.
+ *
+ * Returns 0 on success, non-zero on failure. */
+static int mdbx_page_spill(MDBX_cursor *mc, MDBX_val *key, MDBX_val *data) {
+ if (mc->mc_flags & C_SUB)
+ return MDBX_SUCCESS;
+
+ MDBX_txn *txn = mc->mc_txn;
+ MDBX_DPL dl = txn->tw.dirtylist;
+
+ /* Estimate how much space this op will take */
+ pgno_t i = mc->mc_db->md_depth;
+ /* Named DBs also dirty the main DB */
+ if (mc->mc_dbi >= CORE_DBS)
+ i += txn->mt_dbs[MAIN_DBI].md_depth;
+ /* For puts, roughly factor in the key+data size */
+ if (key)
+ i += bytes2pgno(txn->mt_env, node_size(key, data) + txn->mt_env->me_psize);
+ i += i; /* double it for good measure */
+ pgno_t need = i;
+
+ if (txn->tw.dirtyroom > i)
+ return MDBX_SUCCESS;
+
+ if (!txn->tw.spill_pages) {
+ txn->tw.spill_pages = mdbx_pnl_alloc(MDBX_DPL_TXNFULL / 8);
+ if (unlikely(!txn->tw.spill_pages))
+ return MDBX_ENOMEM;
+ } else {
+ /* purge deleted slots */
+ MDBX_PNL sl = txn->tw.spill_pages;
+ pgno_t num = MDBX_PNL_SIZE(sl), j = 0;
+ for (i = 1; i <= num; i++) {
+ if ((sl[i] & 1) == 0)
+ sl[++j] = sl[i];
+ }
+ MDBX_PNL_SIZE(sl) = j;
+ }
+
+ /* Preserve pages which may soon be dirtied again */
+ int rc = mdbx_pages_xkeep(mc, P_DIRTY, true);
+ if (unlikely(rc != MDBX_SUCCESS))
+ goto bailout;
+
+ /* Less aggressive spill - we originally spilled the entire dirty list,
+ * with a few exceptions for cursor pages and DB root pages. But this
+ * turns out to be a lot of wasted effort because in a large txn many
+ * of those pages will need to be used again. So now we spill only 1/8th
+ * of the dirty pages. Testing revealed this to be a good tradeoff,
+ * better than 1/2, 1/4, or 1/10. */
+ if (need < MDBX_DPL_TXNFULL / 8)
+ need = MDBX_DPL_TXNFULL / 8;
+
+ /* Save the page IDs of all the pages we're flushing */
+ /* flush from the tail forward, this saves a lot of shifting later on. */
+ for (i = dl->length; i && need; i--) {
+ pgno_t pn = dl[i].pgno << 1;
+ MDBX_page *dp = dl[i].ptr;
+ if (dp->mp_flags & (P_LOOSE | P_KEEP))
+ continue;
+ /* Can't spill twice,
+ * make sure it's not already in a parent's spill list. */
+ if (txn->mt_parent) {
+ MDBX_txn *parent;
+ for (parent = txn->mt_parent; parent; parent = parent->mt_parent) {
+ if (parent->tw.spill_pages &&
+ mdbx_pnl_exist(parent->tw.spill_pages, pn)) {
+ dp->mp_flags |= P_KEEP;
+ break;
+ }
+ }
+ if (parent)
+ continue;
+ }
+ rc = mdbx_pnl_append(&txn->tw.spill_pages, pn);
+ if (unlikely(rc != MDBX_SUCCESS))
+ goto bailout;
+ need--;
+ }
+ mdbx_pnl_sort(txn->tw.spill_pages);
+
+ /* Flush the spilled part of dirty list */
+ rc = mdbx_page_flush(txn, i);
+ if (unlikely(rc != MDBX_SUCCESS))
+ goto bailout;
+
+ /* Reset any dirty pages we kept that page_flush didn't see */
+ rc = mdbx_pages_xkeep(mc, P_DIRTY | P_KEEP, i != 0);
+
+bailout:
+ txn->mt_flags |= rc ? MDBX_TXN_ERROR : MDBX_TXN_SPILLS;
+ return rc;
+}
+
+/*----------------------------------------------------------------------------*/
+
+#define METAPAGE(env, n) page_meta(pgno2page(env, n))
+#define METAPAGE_END(env) METAPAGE(env, NUM_METAS)
+
+static __inline txnid_t meta_txnid(const MDBX_env *env, const MDBX_meta *meta,
+ bool allow_volatile) {
+ mdbx_assert(env, meta >= METAPAGE(env, 0) || meta < METAPAGE_END(env));
+ txnid_t a = safe64_read(&meta->mm_txnid_a);
+ txnid_t b = safe64_read(&meta->mm_txnid_b);
+ if (allow_volatile)
+ return (a == b) ? a : 0;
+ mdbx_assert(env, a == b);
+ return a;
+}
+
+static __inline txnid_t mdbx_meta_txnid_stable(const MDBX_env *env,
+ const MDBX_meta *meta) {
+ return meta_txnid(env, meta, false);
+}
+
+static __inline txnid_t mdbx_meta_txnid_fluid(const MDBX_env *env,
+ const MDBX_meta *meta) {
+ return meta_txnid(env, meta, true);
+}
+
+static __inline void mdbx_meta_update_begin(const MDBX_env *env,
+ MDBX_meta *meta, txnid_t txnid) {
+ mdbx_assert(env, meta >= METAPAGE(env, 0) || meta < METAPAGE_END(env));
+ mdbx_assert(env, meta->mm_txnid_a.inconsistent < txnid &&
+ meta->mm_txnid_b.inconsistent < txnid);
+ (void)env;
+ safe64_update(&meta->mm_txnid_a, txnid);
+}
+
+static __inline void mdbx_meta_update_end(const MDBX_env *env, MDBX_meta *meta,
+ txnid_t txnid) {
+ mdbx_assert(env, meta >= METAPAGE(env, 0) || meta < METAPAGE_END(env));
+ mdbx_assert(env, meta->mm_txnid_a.inconsistent == txnid);
+ mdbx_assert(env, meta->mm_txnid_b.inconsistent < txnid);
+ (void)env;
+ mdbx_jitter4testing(true);
+ safe64_update(&meta->mm_txnid_b, txnid);
+}
+
+static __inline void mdbx_meta_set_txnid(const MDBX_env *env, MDBX_meta *meta,
+ txnid_t txnid) {
+ mdbx_assert(env, meta < METAPAGE(env, 0) || meta > METAPAGE_END(env));
+ (void)env;
+ /* update inconsistent since this function used ONLY for filling meta-image
+ * for writing, but not the actual meta-page */
+ meta->mm_txnid_a.inconsistent = txnid;
+ meta->mm_txnid_b.inconsistent = txnid;
+}
+
+static __inline uint64_t mdbx_meta_sign(const MDBX_meta *meta) {
+ uint64_t sign = MDBX_DATASIGN_NONE;
+#if 0 /* TODO */
+ sign = hippeus_hash64(...);
+#else
+ (void)meta;
+#endif
+ /* LY: newer returns MDBX_DATASIGN_NONE or MDBX_DATASIGN_WEAK */
+ return (sign > MDBX_DATASIGN_WEAK) ? sign : ~sign;
+}
+
+enum meta_choise_mode { prefer_last, prefer_noweak, prefer_steady };
+
+static __inline bool mdbx_meta_ot(const enum meta_choise_mode mode,
+ const MDBX_env *env, const MDBX_meta *a,
+ const MDBX_meta *b) {
+ mdbx_jitter4testing(true);
+ txnid_t txnid_a = mdbx_meta_txnid_fluid(env, a);
+ txnid_t txnid_b = mdbx_meta_txnid_fluid(env, b);
+
+ mdbx_jitter4testing(true);
+ switch (mode) {
+ default:
+ assert(false);
+ __unreachable();
+ /* fall through */
+ __fallthrough;
+ case prefer_steady:
+ if (META_IS_STEADY(a) != META_IS_STEADY(b))
+ return META_IS_STEADY(b);
+ /* fall through */
+ __fallthrough;
+ case prefer_noweak:
+ if (META_IS_WEAK(a) != META_IS_WEAK(b))
+ return !META_IS_WEAK(b);
+ /* fall through */
+ __fallthrough;
+ case prefer_last:
+ mdbx_jitter4testing(true);
+ if (txnid_a == txnid_b)
+ return META_IS_STEADY(b) || (META_IS_WEAK(a) && !META_IS_WEAK(b));
+ return txnid_a < txnid_b;
+ }
+}
+
+static __inline bool mdbx_meta_eq(const MDBX_env *env, const MDBX_meta *a,
+ const MDBX_meta *b) {
+ mdbx_jitter4testing(true);
+ const txnid_t txnid = mdbx_meta_txnid_fluid(env, a);
+ if (!txnid || txnid != mdbx_meta_txnid_fluid(env, b))
+ return false;
+
+ mdbx_jitter4testing(true);
+ if (META_IS_STEADY(a) != META_IS_STEADY(b))
+ return false;
+
+ mdbx_jitter4testing(true);
+ return true;
+}
+
+static int mdbx_meta_eq_mask(const MDBX_env *env) {
+ MDBX_meta *m0 = METAPAGE(env, 0);
+ MDBX_meta *m1 = METAPAGE(env, 1);
+ MDBX_meta *m2 = METAPAGE(env, 2);
+
+ int rc = mdbx_meta_eq(env, m0, m1) ? 1 : 0;
+ if (mdbx_meta_eq(env, m1, m2))
+ rc += 2;
+ if (mdbx_meta_eq(env, m2, m0))
+ rc += 4;
+ return rc;
+}
+
+static __inline MDBX_meta *mdbx_meta_recent(const enum meta_choise_mode mode,
+ const MDBX_env *env, MDBX_meta *a,
+ MDBX_meta *b) {
+ const bool a_older_that_b = mdbx_meta_ot(mode, env, a, b);
+ mdbx_assert(env, !mdbx_meta_eq(env, a, b));
+ return a_older_that_b ? b : a;
+}
+
+static __inline MDBX_meta *mdbx_meta_ancient(const enum meta_choise_mode mode,
+ const MDBX_env *env, MDBX_meta *a,
+ MDBX_meta *b) {
+ const bool a_older_that_b = mdbx_meta_ot(mode, env, a, b);
+ mdbx_assert(env, !mdbx_meta_eq(env, a, b));
+ return a_older_that_b ? a : b;
+}
+
+static __inline MDBX_meta *
+mdbx_meta_mostrecent(const enum meta_choise_mode mode, const MDBX_env *env) {
+ MDBX_meta *m0 = METAPAGE(env, 0);
+ MDBX_meta *m1 = METAPAGE(env, 1);
+ MDBX_meta *m2 = METAPAGE(env, 2);
+
+ MDBX_meta *head = mdbx_meta_recent(mode, env, m0, m1);
+ head = mdbx_meta_recent(mode, env, head, m2);
+ return head;
+}
+
+static __hot MDBX_meta *mdbx_meta_steady(const MDBX_env *env) {
+ return mdbx_meta_mostrecent(prefer_steady, env);
+}
+
+static __hot MDBX_meta *mdbx_meta_head(const MDBX_env *env) {
+ return mdbx_meta_mostrecent(prefer_last, env);
+}
+
+static __hot txnid_t mdbx_recent_committed_txnid(const MDBX_env *env) {
+ while (true) {
+ const MDBX_meta *head = mdbx_meta_head(env);
+ const txnid_t recent = mdbx_meta_txnid_fluid(env, head);
+ mdbx_compiler_barrier();
+ if (likely(head == mdbx_meta_head(env) &&
+ recent == mdbx_meta_txnid_fluid(env, head)))
+ return recent;
+ }
+}
+
+static __hot txnid_t mdbx_recent_steady_txnid(const MDBX_env *env) {
+ while (true) {
+ const MDBX_meta *head = mdbx_meta_steady(env);
+ const txnid_t recent = mdbx_meta_txnid_fluid(env, head);
+ mdbx_compiler_barrier();
+ if (likely(head == mdbx_meta_steady(env) &&
+ recent == mdbx_meta_txnid_fluid(env, head)))
+ return recent;
+ }
+}
+
+static __hot txnid_t mdbx_reclaiming_detent(const MDBX_env *env) {
+ if (F_ISSET(env->me_flags, MDBX_UTTERLY_NOSYNC))
+ return likely(env->me_txn0->mt_owner == mdbx_thread_self())
+ ? env->me_txn0->mt_txnid - MDBX_TXNID_STEP
+ : mdbx_recent_committed_txnid(env);
+
+ return mdbx_recent_steady_txnid(env);
+}
+
+static const char *mdbx_durable_str(const MDBX_meta *const meta) {
+ if (META_IS_WEAK(meta))
+ return "Weak";
+ if (META_IS_STEADY(meta))
+ return (meta->mm_datasync_sign == mdbx_meta_sign(meta)) ? "Steady"
+ : "Tainted";
+ return "Legacy";
+}
+
+/*----------------------------------------------------------------------------*/
+
+/* Find oldest txnid still referenced. */
+static txnid_t mdbx_find_oldest(MDBX_txn *txn) {
+ mdbx_tassert(txn, (txn->mt_flags & MDBX_RDONLY) == 0);
+ MDBX_env *env = txn->mt_env;
+ const txnid_t edge = mdbx_reclaiming_detent(env);
+ mdbx_tassert(txn, edge <= txn->mt_txnid);
+
+ MDBX_lockinfo *const lck = env->me_lck;
+ if (unlikely(lck == NULL /* exclusive mode */))
+ return env->me_lckless_stub.oldest = edge;
+
+ const txnid_t last_oldest = lck->mti_oldest_reader;
+ mdbx_tassert(txn, edge >= last_oldest);
+ if (likely(last_oldest == edge))
+ return edge;
+
+ const uint32_t nothing_changed = MDBX_STRING_TETRAD("None");
+ const uint32_t snap_readers_refresh_flag = lck->mti_readers_refresh_flag;
+ mdbx_jitter4testing(false);
+ if (snap_readers_refresh_flag == nothing_changed)
+ return last_oldest;
+
+ txnid_t oldest = edge;
+ lck->mti_readers_refresh_flag = nothing_changed;
+ mdbx_flush_noncoherent_cpu_writeback();
+ const unsigned snap_nreaders = lck->mti_numreaders;
+ for (unsigned i = 0; i < snap_nreaders; ++i) {
+ if (lck->mti_readers[i].mr_pid) {
+ /* mdbx_jitter4testing(true); */
+ const txnid_t snap = safe64_read(&lck->mti_readers[i].mr_txnid);
+ if (oldest > snap && last_oldest <= /* ignore pending updates */ snap) {
+ oldest = snap;
+ if (oldest == last_oldest)
+ return oldest;
+ }
+ }
+ }
+
+ if (oldest != last_oldest) {
+ mdbx_notice("update oldest %" PRIaTXN " -> %" PRIaTXN, last_oldest, oldest);
+ mdbx_tassert(txn, oldest >= lck->mti_oldest_reader);
+ lck->mti_oldest_reader = oldest;
+ }
+ return oldest;
+}
+
+/* Find largest mvcc-snapshot still referenced. */
+static __cold pgno_t mdbx_find_largest(MDBX_env *env, pgno_t largest) {
+ MDBX_lockinfo *const lck = env->me_lck;
+ if (likely(lck != NULL /* exclusive mode */)) {
+ const unsigned snap_nreaders = lck->mti_numreaders;
+ for (unsigned i = 0; i < snap_nreaders; ++i) {
+ retry:
+ if (lck->mti_readers[i].mr_pid) {
+ /* mdbx_jitter4testing(true); */
+ const pgno_t snap_pages = lck->mti_readers[i].mr_snapshot_pages_used;
+ const txnid_t snap_txnid = safe64_read(&lck->mti_readers[i].mr_txnid);
+ mdbx_memory_barrier();
+ if (unlikely(snap_pages != lck->mti_readers[i].mr_snapshot_pages_used ||
+ snap_txnid != safe64_read(&lck->mti_readers[i].mr_txnid)))
+ goto retry;
+ if (largest < snap_pages &&
+ lck->mti_oldest_reader <= /* ignore pending updates */ snap_txnid &&
+ snap_txnid <= env->me_txn0->mt_txnid)
+ largest = snap_pages;
+ }
+ }
+ }
+
+ return largest;
+}
+
+/* Add a page to the txn's dirty list */
+static int __must_check_result mdbx_page_dirty(MDBX_txn *txn, MDBX_page *mp) {
+ const int rc = mdbx_dpl_append(txn->tw.dirtylist, mp->mp_pgno, mp);
+ if (unlikely(rc != MDBX_SUCCESS)) {
+ txn->mt_flags |= MDBX_TXN_ERROR;
+ return rc;
+ }
+ txn->tw.dirtyroom--;
+ mdbx_tassert(txn, txn->mt_parent ||
+ txn->tw.dirtyroom + txn->tw.dirtylist->length ==
+ MDBX_DPL_TXNFULL);
+ return MDBX_SUCCESS;
+}
+
+/* Turn on/off readahead. It's harmful when the DB is larger than RAM. */
+static int __cold mdbx_set_readahead(MDBX_env *env, const size_t offset,
+ const size_t length, const bool enable) {
+ assert(length > 0);
+ mdbx_notice("readahead %s %u..%u", enable ? "ON" : "OFF",
+ bytes2pgno(env, offset), bytes2pgno(env, offset + length));
+
+#if defined(F_RDAHEAD)
+ if (unlikely(fcntl(env->me_fd, F_RDAHEAD, enable) == -1))
+ return errno;
+#endif /* F_RDAHEAD */
+
+ if (enable) {
+#if defined(F_RDADVISE)
+ struct radvisory hint;
+ hint.ra_offset = offset;
+ hint.ra_count = length;
+ (void)/* Ignore ENOTTY for DB on the ram-disk and so on */ fcntl(
+ env->me_fd, F_RDADVISE, &hint);
+#endif /* F_RDADVISE */
+#if defined(MADV_WILLNEED)
+ if (unlikely(madvise(env->me_map + offset, length, MADV_WILLNEED) != 0))
+ return errno;
+#elif defined(POSIX_MADV_WILLNEED)
+ rc = posix_madvise(env->me_map + offset, length, POSIX_MADV_WILLNEED);
+ if (unlikely(rc != 0))
+ return errno;
+#elif defined(_WIN32) || defined(_WIN64)
+ if (mdbx_PrefetchVirtualMemory) {
+ WIN32_MEMORY_RANGE_ENTRY hint;
+ hint.VirtualAddress = env->me_map + offset;
+ hint.NumberOfBytes = length;
+ (void)mdbx_PrefetchVirtualMemory(GetCurrentProcess(), 1, &hint, 0);
+ }
+#elif defined(POSIX_FADV_WILLNEED)
+ int err = posix_fadvise(env->me_fd, offset, length, POSIX_FADV_WILLNEED);
+ if (unlikely(err != 0))
+ return err;
+#endif /* MADV_WILLNEED */
+ } else {
+#if defined(MADV_RANDOM)
+ if (unlikely(madvise(env->me_map + offset, length, MADV_RANDOM) != 0))
+ return errno;
+#elif defined(POSIX_MADV_RANDOM)
+ int err = posix_madvise(env->me_map + offset, length, POSIX_MADV_RANDOM);
+ if (unlikely(err != 0))
+ return err;
+#elif defined(POSIX_FADV_RANDOM)
+ int err = posix_fadvise(env->me_fd, offset, length, POSIX_FADV_RANDOM);
+ if (unlikely(err != 0))
+ return err;
+#endif /* MADV_RANDOM */
+ }
+ return MDBX_SUCCESS;
+}
+
+static __cold int mdbx_mapresize(MDBX_env *env, const pgno_t size_pgno,
+ const pgno_t limit_pgno) {
+ const size_t limit_bytes = pgno_align2os_bytes(env, limit_pgno);
+ const size_t size_bytes = pgno_align2os_bytes(env, size_pgno);
+
+ mdbx_verbose("resize datafile/mapping: "
+ "present %" PRIuPTR " -> %" PRIuPTR ", "
+ "limit %" PRIuPTR " -> %" PRIuPTR,
+ env->me_dxb_mmap.current, size_bytes, env->me_dxb_mmap.limit,
+ limit_bytes);
+
+ mdbx_assert(env, limit_bytes >= size_bytes);
+ mdbx_assert(env, bytes2pgno(env, size_bytes) >= size_pgno);
+ mdbx_assert(env, bytes2pgno(env, limit_bytes) >= limit_pgno);
+
+#if defined(_WIN32) || defined(_WIN64)
+ /* Acquire guard in exclusive mode for:
+ * - to avoid collision between read and write txns around env->me_dbgeo;
+ * - to avoid attachment of new reading threads (see mdbx_rdt_lock); */
+ mdbx_srwlock_AcquireExclusive(&env->me_remap_guard);
+ mdbx_handle_array_t *suspended = NULL;
+ mdbx_handle_array_t array_onstack;
+ int rc = MDBX_SUCCESS;
+ if (limit_bytes == env->me_dxb_mmap.limit &&
+ size_bytes == env->me_dxb_mmap.current &&
+ size_bytes == env->me_dxb_mmap.filesize)
+ goto bailout;
+
+ /* 1) Windows allows only extending a read-write section, but not a
+ * corresponing mapped view. Therefore in other cases we must suspend
+ * the local threads for safe remap.
+ * 2) At least on Windows 10 1803 the entire mapped section is unavailable
+ * for short time during NtExtendSection() or VirtualAlloc() execution.
+ *
+ * THEREFORE LOCAL THREADS SUSPENDING IS ALWAYS REQUIRED! */
+ array_onstack.limit = ARRAY_LENGTH(array_onstack.handles);
+ array_onstack.count = 0;
+ suspended = &array_onstack;
+ rc = mdbx_suspend_threads_before_remap(env, &suspended);
+ if (rc != MDBX_SUCCESS) {
+ mdbx_error("failed suspend-for-remap: errcode %d", rc);
+ goto bailout;
+ }
+#else
+ /* Acquire guard to avoid collision between read and write txns
+ * around env->me_dbgeo */
+ int rc = mdbx_fastmutex_acquire(&env->me_remap_guard);
+ if (rc != MDBX_SUCCESS)
+ return rc;
+ if (limit_bytes == env->me_dxb_mmap.limit &&
+ size_bytes == env->me_dxb_mmap.current)
+ goto bailout;
+#endif /* Windows */
+
+ const size_t prev_limit = env->me_dxb_mmap.limit;
+ const void *const prev_addr = env->me_map;
+ const size_t prev_size = env->me_dxb_mmap.current;
+ if (size_bytes < prev_size) {
+ mdbx_notice("resize-MADV_%s %u..%u",
+ (env->me_flags & MDBX_WRITEMAP) ? "REMOVE" : "DONTNEED",
+ size_pgno, bytes2pgno(env, prev_size));
+#if defined(MADV_REMOVE)
+ if ((env->me_flags & MDBX_WRITEMAP) == 0 ||
+ madvise(env->me_map + size_bytes, prev_size - size_bytes,
+ MADV_REMOVE) != 0)
+#endif
+#if defined(MADV_DONTNEED)
+ (void)madvise(env->me_map + size_bytes, prev_size - size_bytes,
+ MADV_DONTNEED);
+#elif defined(POSIX_MADV_DONTNEED)
+ (void)posix_madvise(env->me_map + size_bytes, prev_size - size_bytes,
+ POSIX_MADV_DONTNEED);
+#elif defined(POSIX_FADV_DONTNEED)
+ (void)posix_fadvise(env->me_fd, size_bytes, prev_size - size_bytes,
+ POSIX_FADV_DONTNEED);
+#else
+ __noop();
+#endif /* MADV_DONTNEED */
+ if (*env->me_discarded_tail > size_pgno)
+ *env->me_discarded_tail = size_pgno;
+ }
+
+ rc = mdbx_mresize(env->me_flags, &env->me_dxb_mmap, size_bytes, limit_bytes);
+ if (rc == MDBX_SUCCESS && (env->me_flags & MDBX_NORDAHEAD) == 0) {
+ rc = mdbx_is_readahead_reasonable(size_bytes, 0);
+ if (rc == MDBX_RESULT_FALSE)
+ rc = mdbx_set_readahead(
+ env, 0, (size_bytes > prev_size) ? size_bytes : prev_size, false);
+ else if (rc == MDBX_RESULT_TRUE) {
+ rc = MDBX_SUCCESS;
+ const size_t readahead_pivot =
+ (limit_bytes != prev_limit || env->me_dxb_mmap.address != prev_addr
+#if defined(_WIN32) || defined(_WIN64)
+ || prev_size > size_bytes
+#endif /* Windows */
+ )
+ ? 0 /* reassign readahead to the entire map
+ because it was remapped */
+ : prev_size;
+ if (size_bytes > readahead_pivot) {
+ *env->me_discarded_tail = size_pgno;
+ rc = mdbx_set_readahead(env, readahead_pivot,
+ size_bytes - readahead_pivot, true);
+ }
+ }
+ }
+
+bailout:
+ if (rc == MDBX_SUCCESS) {
+#if defined(_WIN32) || defined(_WIN64)
+ mdbx_assert(env, size_bytes == env->me_dxb_mmap.current);
+ mdbx_assert(env, size_bytes <= env->me_dxb_mmap.filesize);
+ mdbx_assert(env, limit_bytes == env->me_dxb_mmap.limit);
+#endif /* Windows */
+#ifdef MDBX_USE_VALGRIND
+ if (prev_limit != env->me_dxb_mmap.limit || prev_addr != env->me_map) {
+ VALGRIND_DISCARD(env->me_valgrind_handle);
+ env->me_valgrind_handle = 0;
+ if (env->me_dxb_mmap.limit)
+ env->me_valgrind_handle =
+ VALGRIND_CREATE_BLOCK(env->me_map, env->me_dxb_mmap.limit, "mdbx");
+ }
+#endif /* MDBX_USE_VALGRIND */
+ } else {
+ if (rc != MDBX_RESULT_TRUE) {
+ mdbx_error("failed resize datafile/mapping: "
+ "present %" PRIuPTR " -> %" PRIuPTR ", "
+ "limit %" PRIuPTR " -> %" PRIuPTR ", errcode %d",
+ env->me_dxb_mmap.current, size_bytes, env->me_dxb_mmap.limit,
+ limit_bytes, rc);
+ } else {
+ mdbx_notice("unable resize datafile/mapping: "
+ "present %" PRIuPTR " -> %" PRIuPTR ", "
+ "limit %" PRIuPTR " -> %" PRIuPTR ", errcode %d",
+ env->me_dxb_mmap.current, size_bytes, env->me_dxb_mmap.limit,
+ limit_bytes, rc);
+ }
+ if (!env->me_dxb_mmap.address) {
+ env->me_flags |= MDBX_FATAL_ERROR;
+ if (env->me_txn)
+ env->me_txn->mt_flags |= MDBX_TXN_ERROR;
+ rc = MDBX_PANIC;
+ }
+ }
+
+#if defined(_WIN32) || defined(_WIN64)
+ int err = MDBX_SUCCESS;
+ mdbx_srwlock_ReleaseExclusive(&env->me_remap_guard);
+ if (suspended) {
+ err = mdbx_resume_threads_after_remap(suspended);
+ if (suspended != &array_onstack)
+ mdbx_free(suspended);
+ }
+#else
+ int err = mdbx_fastmutex_release(&env->me_remap_guard);
+#endif /* Windows */
+ if (err != MDBX_SUCCESS) {
+ mdbx_fatal("failed resume-after-remap: errcode %d", err);
+ return MDBX_PANIC;
+ }
+ return rc;
+}
+
+/* Allocate page numbers and memory for writing. Maintain mt_last_reclaimed,
+ * mt_reclaimed_pglist and mt_next_pgno. Set MDBX_TXN_ERROR on failure.
+ *
+ * If there are free pages available from older transactions, they
+ * are re-used first. Otherwise allocate a new page at mt_next_pgno.
+ * Do not modify the GC, just merge GC records into mt_reclaimed_pglist
+ * and move mt_last_reclaimed to say which records were consumed. Only this
+ * function can create mt_reclaimed_pglist and move
+ * mt_last_reclaimed/mt_next_pgno.
+ *
+ * [in] mc cursor A cursor handle identifying the transaction and
+ * database for which we are allocating.
+ * [in] num the number of pages to allocate.
+ * [out] mp Address of the allocated page(s). Requests for multiple pages
+ * will always be satisfied by a single contiguous chunk of memory.
+ *
+ * Returns 0 on success, non-zero on failure.*/
+
+#define MDBX_ALLOC_CACHE 1
+#define MDBX_ALLOC_GC 2
+#define MDBX_ALLOC_NEW 4
+#define MDBX_ALLOC_KICK 8
+#define MDBX_ALLOC_ALL \
+ (MDBX_ALLOC_CACHE | MDBX_ALLOC_GC | MDBX_ALLOC_NEW | MDBX_ALLOC_KICK)
+
+static int mdbx_page_alloc(MDBX_cursor *mc, unsigned num, MDBX_page **mp,
+ int flags) {
+ int rc;
+ MDBX_txn *txn = mc->mc_txn;
+ MDBX_env *env = txn->mt_env;
+ MDBX_page *np;
+
+ if (likely(flags & MDBX_ALLOC_GC)) {
+ flags |= env->me_flags & (MDBX_COALESCE | MDBX_LIFORECLAIM);
+ if (unlikely(mc->mc_flags & C_RECLAIMING)) {
+ /* If mc is updating the GC, then the retired-list cannot play
+ * catch-up with itself by growing while trying to save it. */
+ flags &=
+ ~(MDBX_ALLOC_GC | MDBX_ALLOC_KICK | MDBX_COALESCE | MDBX_LIFORECLAIM);
+ } else if (unlikely(txn->mt_dbs[FREE_DBI].md_entries == 0)) {
+ /* avoid (recursive) search inside empty tree and while tree is updating,
+ * https://github.com/leo-yuriev/libmdbx/issues/31 */
+ flags &= ~MDBX_ALLOC_GC;
+ }
+ }
+
+ if (likely(flags & MDBX_ALLOC_CACHE)) {
+ /* If there are any loose pages, just use them */
+ mdbx_assert(env, mp && num);
+ if (likely(num == 1 && txn->tw.loose_pages)) {
+ if (txn->tw.loose_refund_wl > txn->mt_next_pgno) {
+ mdbx_refund(txn);
+ if (unlikely(!txn->tw.loose_pages))
+ goto skip_cache;
+ }
+
+ np = txn->tw.loose_pages;
+ txn->tw.loose_pages = np->mp_next;
+ txn->tw.loose_count--;
+ mdbx_debug("db %d use loose page %" PRIaPGNO, DDBI(mc), np->mp_pgno);
+ mdbx_tassert(txn, np->mp_pgno < txn->mt_next_pgno);
+ mdbx_ensure(env, np->mp_pgno >= NUM_METAS);
+ VALGRIND_MAKE_MEM_UNDEFINED(page_data(np), page_space(txn->mt_env));
+ ASAN_UNPOISON_MEMORY_REGION(page_data(np), page_space(txn->mt_env));
+ *mp = np;
+ return MDBX_SUCCESS;
+ }
+ }
+skip_cache:
+
+ mdbx_tassert(
+ txn, mdbx_pnl_check4assert(txn->tw.reclaimed_pglist, txn->mt_next_pgno));
+ pgno_t pgno, *re_list = txn->tw.reclaimed_pglist;
+ unsigned range_begin = 0, re_len = MDBX_PNL_SIZE(re_list);
+ txnid_t oldest = 0, last = 0;
+ const unsigned wanna_range = num - 1;
+
+ while (1) { /* oom-kick retry loop */
+ /* If our dirty list is already full, we can't do anything */
+ if (unlikely(txn->tw.dirtyroom == 0)) {
+ rc = MDBX_TXN_FULL;
+ goto fail;
+ }
+
+ MDBX_cursor recur;
+ for (MDBX_cursor_op op = MDBX_FIRST;;
+ op = (flags & MDBX_LIFORECLAIM) ? MDBX_PREV : MDBX_NEXT) {
+ MDBX_val key, data;
+
+ /* Seek a big enough contiguous page range.
+ * Prefer pages with lower pgno. */
+ mdbx_tassert(txn, mdbx_pnl_check4assert(txn->tw.reclaimed_pglist,
+ txn->mt_next_pgno));
+ if (likely(flags & MDBX_ALLOC_CACHE) && re_len > wanna_range &&
+ (!(flags & MDBX_COALESCE) || op == MDBX_FIRST)) {
+ mdbx_tassert(txn, MDBX_PNL_LAST(re_list) < txn->mt_next_pgno &&
+ MDBX_PNL_FIRST(re_list) < txn->mt_next_pgno);
+ range_begin = MDBX_PNL_ASCENDING ? 1 : re_len;
+ pgno = MDBX_PNL_LEAST(re_list);
+ if (likely(wanna_range == 0))
+ goto done;
+#if MDBX_PNL_ASCENDING
+ mdbx_tassert(txn, pgno == re_list[1] && range_begin == 1);
+ while (true) {
+ unsigned range_end = range_begin + wanna_range;
+ if (re_list[range_end] - pgno == wanna_range)
+ goto done;
+ if (range_end == re_len)
+ break;
+ pgno = re_list[++range_begin];
+ }
+#else
+ mdbx_tassert(txn, pgno == re_list[re_len] && range_begin == re_len);
+ while (true) {
+ if (re_list[range_begin - wanna_range] - pgno == wanna_range)
+ goto done;
+ if (range_begin == wanna_range)
+ break;
+ pgno = re_list[--range_begin];
+ }
+#endif /* MDBX_PNL sort-order */
+ }
+
+ if (op == MDBX_FIRST) { /* 1st iteration, setup cursor, etc */
+ if (unlikely(!(flags & MDBX_ALLOC_GC)))
+ break /* reclaiming is prohibited for now */;
+
+ /* Prepare to fetch more and coalesce */
+ oldest = (flags & MDBX_LIFORECLAIM) ? mdbx_find_oldest(txn)
+ : *env->me_oldest;
+ rc = mdbx_cursor_init(&recur, txn, FREE_DBI);
+ if (unlikely(rc != MDBX_SUCCESS))
+ goto fail;
+ if (flags & MDBX_LIFORECLAIM) {
+ /* Begin from oldest reader if any */
+ if (oldest > 2) {
+ last = oldest - 1;
+ op = MDBX_SET_RANGE;
+ }
+ } else if (txn->tw.last_reclaimed) {
+ /* Continue lookup from txn->tw.last_reclaimed to oldest reader */
+ last = txn->tw.last_reclaimed;
+ op = MDBX_SET_RANGE;
+ }
+
+ key.iov_base = &last;
+ key.iov_len = sizeof(last);
+ }
+
+ if (!(flags & MDBX_LIFORECLAIM)) {
+ /* Do not try fetch more if the record will be too recent */
+ if (op != MDBX_FIRST && ++last >= oldest) {
+ oldest = mdbx_find_oldest(txn);
+ if (oldest <= last)
+ break;
+ }
+ }
+
+ rc = mdbx_cursor_get(&recur, &key, NULL, op);
+ if (rc == MDBX_NOTFOUND && (flags & MDBX_LIFORECLAIM)) {
+ if (op == MDBX_SET_RANGE)
+ continue;
+ txnid_t snap = mdbx_find_oldest(txn);
+ if (oldest < snap) {
+ oldest = snap;
+ last = oldest - 1;
+ key.iov_base = &last;
+ key.iov_len = sizeof(last);
+ op = MDBX_SET_RANGE;
+ rc = mdbx_cursor_get(&recur, &key, NULL, op);
+ }
+ }
+ if (unlikely(rc)) {
+ if (rc == MDBX_NOTFOUND)
+ break;
+ goto fail;
+ }
+
+ if (unlikely(key.iov_len != sizeof(txnid_t))) {
+ rc = MDBX_CORRUPTED;
+ goto fail;
+ }
+ last = unaligned_peek_u64(4, key.iov_base);
+ if (unlikely(last < 1 || last >= SAFE64_INVALID_THRESHOLD)) {
+ rc = MDBX_CORRUPTED;
+ goto fail;
+ }
+ if (oldest <= last) {
+ oldest = mdbx_find_oldest(txn);
+ if (oldest <= last) {
+ if (flags & MDBX_LIFORECLAIM)
+ continue;
+ break;
+ }
+ }
+
+ if (flags & MDBX_LIFORECLAIM) {
+ /* skip IDs of records that already reclaimed */
+ if (txn->tw.lifo_reclaimed) {
+ unsigned i;
+ for (i = (unsigned)MDBX_PNL_SIZE(txn->tw.lifo_reclaimed); i > 0; --i)
+ if (txn->tw.lifo_reclaimed[i] == last)
+ break;
+ if (i)
+ continue;
+ }
+ }
+
+ /* Reading next GC record */
+ np = recur.mc_pg[recur.mc_top];
+ if (unlikely((rc = mdbx_node_read(
+ &recur, page_node(np, recur.mc_ki[recur.mc_top]),
+ &data)) != MDBX_SUCCESS))
+ goto fail;
+
+ if ((flags & MDBX_LIFORECLAIM) && !txn->tw.lifo_reclaimed) {
+ txn->tw.lifo_reclaimed = mdbx_txl_alloc();
+ if (unlikely(!txn->tw.lifo_reclaimed)) {
+ rc = MDBX_ENOMEM;
+ goto fail;
+ }
+ }
+
+ /* Append PNL from GC record to me_reclaimed_pglist */
+ mdbx_cassert(mc, (mc->mc_flags & C_GCFREEZE) == 0);
+ pgno_t *gc_pnl = (pgno_t *)data.iov_base;
+ mdbx_tassert(txn, data.iov_len >= MDBX_PNL_SIZEOF(gc_pnl));
+ if (unlikely(data.iov_len < MDBX_PNL_SIZEOF(gc_pnl) ||
+ !mdbx_pnl_check(gc_pnl, txn->mt_next_pgno))) {
+ rc = MDBX_CORRUPTED;
+ goto fail;
+ }
+ const unsigned gc_len = MDBX_PNL_SIZE(gc_pnl);
+ rc = mdbx_pnl_need(&txn->tw.reclaimed_pglist, gc_len);
+ if (unlikely(rc != MDBX_SUCCESS))
+ goto fail;
+ re_list = txn->tw.reclaimed_pglist;
+
+ /* Remember ID of GC record */
+ if (flags & MDBX_LIFORECLAIM) {
+ if ((rc = mdbx_txl_append(&txn->tw.lifo_reclaimed, last)) != 0)
+ goto fail;
+ }
+ txn->tw.last_reclaimed = last;
+
+ if (mdbx_log_enabled(MDBX_LOG_EXTRA)) {
+ mdbx_debug_extra("PNL read txn %" PRIaTXN " root %" PRIaPGNO
+ " num %u, PNL",
+ last, txn->mt_dbs[FREE_DBI].md_root, gc_len);
+ unsigned i;
+ for (i = gc_len; i; i--)
+ mdbx_debug_extra_print(" %" PRIaPGNO, gc_pnl[i]);
+ mdbx_debug_extra_print("%s", "\n");
+ }
+
+ /* Merge in descending sorted order */
+ const unsigned prev_re_len = MDBX_PNL_SIZE(re_list);
+ mdbx_pnl_xmerge(re_list, gc_pnl);
+ /* re-check to avoid duplicates */
+ if (unlikely(!mdbx_pnl_check(re_list, txn->mt_next_pgno))) {
+ rc = MDBX_CORRUPTED;
+ goto fail;
+ }
+
+ re_len = MDBX_PNL_SIZE(re_list);
+ mdbx_tassert(txn, re_len == 0 || re_list[re_len] < txn->mt_next_pgno);
+ if (re_len && unlikely(MDBX_PNL_MOST(re_list) == txn->mt_next_pgno - 1)) {
+ /* Refund suitable pages into "unallocated" space */
+ mdbx_refund(txn);
+ re_list = txn->tw.reclaimed_pglist;
+ re_len = MDBX_PNL_SIZE(re_list);
+ }
+
+ if (unlikely((flags & MDBX_ALLOC_CACHE) == 0)) {
+ /* Done for a kick-reclaim mode, actually no page needed */
+ return MDBX_SUCCESS;
+ }
+
+ /* Don't try to coalesce too much. */
+ if (unlikely(re_len > MDBX_DPL_TXNFULL / 4))
+ break;
+ if (re_len /* current size */ >= env->me_maxgc_ov1page ||
+ (re_len > prev_re_len && re_len - prev_re_len /* delta from prev */ >=
+ env->me_maxgc_ov1page / 2))
+ flags &= ~MDBX_COALESCE;
+ }
+
+ if ((flags & (MDBX_COALESCE | MDBX_ALLOC_CACHE)) ==
+ (MDBX_COALESCE | MDBX_ALLOC_CACHE) &&
+ re_len > wanna_range) {
+ range_begin = MDBX_PNL_ASCENDING ? 1 : re_len;
+ pgno = MDBX_PNL_LEAST(re_list);
+ if (likely(wanna_range == 0))
+ goto done;
+#if MDBX_PNL_ASCENDING
+ mdbx_tassert(txn, pgno == re_list[1] && range_begin == 1);
+ while (true) {
+ unsigned range_end = range_begin + wanna_range;
+ if (re_list[range_end] - pgno == wanna_range)
+ goto done;
+ if (range_end == re_len)
+ break;
+ pgno = re_list[++range_begin];
+ }
+#else
+ mdbx_tassert(txn, pgno == re_list[re_len] && range_begin == re_len);
+ while (true) {
+ if (re_list[range_begin - wanna_range] - pgno == wanna_range)
+ goto done;
+ if (range_begin == wanna_range)
+ break;
+ pgno = re_list[--range_begin];
+ }
+#endif /* MDBX_PNL sort-order */
+ }
+
+ /* Use new pages from the map when nothing suitable in the GC */
+ range_begin = 0;
+ pgno = txn->mt_next_pgno;
+ rc = MDBX_MAP_FULL;
+ const pgno_t next = pgno_add(pgno, num);
+ if (likely(next <= txn->mt_end_pgno)) {
+ rc = MDBX_NOTFOUND;
+ if (likely(flags & MDBX_ALLOC_NEW))
+ goto done;
+ }
+
+ const MDBX_meta *head = mdbx_meta_head(env);
+ if ((flags & MDBX_ALLOC_GC) &&
+ ((flags & MDBX_ALLOC_KICK) || rc == MDBX_MAP_FULL)) {
+ MDBX_meta *steady = mdbx_meta_steady(env);
+
+ if (oldest == mdbx_meta_txnid_stable(env, steady) &&
+ !META_IS_STEADY(head) && META_IS_STEADY(steady)) {
+ /* LY: Here an oom was happened:
+ * - all pages had allocated;
+ * - reclaiming was stopped at the last steady-sync;
+ * - the head-sync is weak.
+ * Now we need make a sync to resume reclaiming. If both
+ * MDBX_NOSYNC and MDBX_MAPASYNC flags are set, then assume that
+ * utterly no-sync write mode was requested. In such case
+ * don't make a steady-sync, but only a legacy-mode checkpoint,
+ * just for resume reclaiming only, not for data consistency. */
+
+ mdbx_debug("kick-gc: head %" PRIaTXN "-%s, tail %" PRIaTXN
+ "-%s, oldest %" PRIaTXN,
+ mdbx_meta_txnid_stable(env, head), mdbx_durable_str(head),
+ mdbx_meta_txnid_stable(env, steady),
+ mdbx_durable_str(steady), oldest);
+
+ const unsigned syncflags = F_ISSET(env->me_flags, MDBX_UTTERLY_NOSYNC)
+ ? env->me_flags
+ : env->me_flags & MDBX_WRITEMAP;
+ MDBX_meta meta = *head;
+ if (mdbx_sync_locked(env, syncflags, &meta) == MDBX_SUCCESS) {
+ txnid_t snap = mdbx_find_oldest(txn);
+ if (snap > oldest)
+ continue;
+ }
+ }
+
+ if (rc == MDBX_MAP_FULL && oldest < txn->mt_txnid - MDBX_TXNID_STEP) {
+ if (mdbx_oomkick(env, oldest) > oldest)
+ continue;
+ }
+ }
+
+ if (rc == MDBX_MAP_FULL && next < head->mm_geo.upper) {
+ mdbx_assert(env, next > txn->mt_end_pgno);
+ pgno_t aligned = pgno_align2os_pgno(
+ env, pgno_add(next, head->mm_geo.grow - next % head->mm_geo.grow));
+
+ if (aligned > head->mm_geo.upper)
+ aligned = head->mm_geo.upper;
+ mdbx_assert(env, aligned > txn->mt_end_pgno);
+
+ mdbx_verbose("try growth datafile to %" PRIaPGNO " pages (+%" PRIaPGNO
+ ")",
+ aligned, aligned - txn->mt_end_pgno);
+ rc = mdbx_mapresize(env, aligned, head->mm_geo.upper);
+ if (rc == MDBX_SUCCESS) {
+ env->me_txn->mt_end_pgno = aligned;
+ if (!mp)
+ return rc;
+ goto done;
+ }
+
+ mdbx_warning("unable growth datafile to %" PRIaPGNO "pages (+%" PRIaPGNO
+ "), errcode %d",
+ aligned, aligned - txn->mt_end_pgno, rc);
+ }
+
+ fail:
+ mdbx_tassert(txn, mdbx_pnl_check4assert(txn->tw.reclaimed_pglist,
+ txn->mt_next_pgno));
+ if (mp) {
+ *mp = NULL;
+ txn->mt_flags |= MDBX_TXN_ERROR;
+ }
+ mdbx_assert(env, rc != MDBX_SUCCESS);
+ return rc;
+ }
+
+done:
+ mdbx_tassert(txn, mp && num);
+ mdbx_ensure(env, pgno >= NUM_METAS);
+ if (env->me_flags & MDBX_WRITEMAP) {
+ np = pgno2page(env, pgno);
+ /* LY: reset no-access flag from mdbx_loose_page() */
+ VALGRIND_MAKE_MEM_UNDEFINED(np, pgno2bytes(env, num));
+ ASAN_UNPOISON_MEMORY_REGION(np, pgno2bytes(env, num));
+ } else {
+ if (unlikely(!(np = mdbx_page_malloc(txn, num)))) {
+ rc = MDBX_ENOMEM;
+ goto fail;
+ }
+ }
+
+ if (range_begin) {
+ mdbx_cassert(mc, (mc->mc_flags & C_GCFREEZE) == 0);
+ mdbx_tassert(txn, pgno < txn->mt_next_pgno);
+ mdbx_tassert(txn, pgno == re_list[range_begin]);
+ /* Cutoff allocated pages from me_reclaimed_pglist */
+#if MDBX_PNL_ASCENDING
+ for (unsigned i = range_begin + num; i <= re_len;)
+ re_list[range_begin++] = re_list[i++];
+ MDBX_PNL_SIZE(re_list) = re_len = range_begin - 1;
+#else
+ MDBX_PNL_SIZE(re_list) = re_len -= num;
+ for (unsigned i = range_begin - num; i < re_len;)
+ re_list[++i] = re_list[++range_begin];
+#endif
+ mdbx_tassert(txn, mdbx_pnl_check4assert(txn->tw.reclaimed_pglist,
+ txn->mt_next_pgno));
+ } else {
+ txn->mt_next_pgno = pgno + num;
+ mdbx_assert(env, txn->mt_next_pgno <= txn->mt_end_pgno);
+ }
+
+ if (unlikely(env->me_flags & MDBX_PAGEPERTURB))
+ memset(np, -1, pgno2bytes(env, num));
+ VALGRIND_MAKE_MEM_UNDEFINED(np, pgno2bytes(env, num));
+
+ np->mp_pgno = pgno;
+ np->mp_leaf2_ksize = 0;
+ np->mp_flags = 0;
+ np->mp_pages = num;
+ rc = mdbx_page_dirty(txn, np);
+ if (unlikely(rc != MDBX_SUCCESS))
+ goto fail;
+ *mp = np;
+
+ mdbx_tassert(
+ txn, mdbx_pnl_check4assert(txn->tw.reclaimed_pglist, txn->mt_next_pgno));
+ return MDBX_SUCCESS;
+}
+
+/* Copy the used portions of a non-overflow page.
+ * [in] dst page to copy into
+ * [in] src page to copy from
+ * [in] psize size of a page */
+__hot static void mdbx_page_copy(MDBX_page *dst, MDBX_page *src,
+ unsigned psize) {
+ STATIC_ASSERT(UINT16_MAX > MAX_PAGESIZE - PAGEHDRSZ);
+ STATIC_ASSERT(MIN_PAGESIZE > PAGEHDRSZ + NODESIZE * 4);
+ if (!IS_LEAF2(src)) {
+ size_t upper = src->mp_upper, lower = src->mp_lower, unused = upper - lower;
+
+ /* If page isn't full, just copy the used portion. Adjust
+ * alignment so memcpy may copy words instead of bytes. */
+ if (unused > sizeof(void *) * 42) {
+ lower = roundup_powerof2(lower + PAGEHDRSZ, sizeof(void *));
+ upper = (upper + PAGEHDRSZ) & ~(sizeof(void *) - 1);
+ memcpy(dst, src, lower);
+ memcpy((char *)dst + upper, (char *)src + upper, psize - upper);
+ return;
+ }
+ }
+ memcpy(dst, src, psize);
+}
+
+/* Pull a page off the txn's spill list, if present.
+ *
+ * If a page being referenced was spilled to disk in this txn, bring
+ * it back and make it dirty/writable again.
+ *
+ * [in] txn the transaction handle.
+ * [in] mp the page being referenced. It must not be dirty.
+ * [out] ret the writable page, if any.
+ * ret is unchanged if mp wasn't spilled. */
+__hot static int __must_check_result mdbx_page_unspill(MDBX_txn *txn,
+ MDBX_page *mp,
+ MDBX_page **ret) {
+ MDBX_env *env = txn->mt_env;
+ pgno_t pgno = mp->mp_pgno, pn = pgno << 1;
+
+ for (const MDBX_txn *tx2 = txn; tx2; tx2 = tx2->mt_parent) {
+ if (!tx2->tw.spill_pages)
+ continue;
+ unsigned i = mdbx_pnl_exist(tx2->tw.spill_pages, pn);
+ if (!i)
+ continue;
+ if (txn->tw.dirtyroom == 0)
+ return MDBX_TXN_FULL;
+ unsigned num = IS_OVERFLOW(mp) ? mp->mp_pages : 1;
+ MDBX_page *np = mp;
+ if ((env->me_flags & MDBX_WRITEMAP) == 0) {
+ np = mdbx_page_malloc(txn, num);
+ if (unlikely(!np))
+ return MDBX_ENOMEM;
+ if (unlikely(num > 1))
+ memcpy(np, mp, pgno2bytes(env, num));
+ else
+ mdbx_page_copy(np, mp, env->me_psize);
+ }
+ mdbx_debug("unspill page %" PRIaPGNO, mp->mp_pgno);
+ if (tx2 == txn) {
+ /* If in current txn, this page is no longer spilled.
+ * If it happens to be the last page, truncate the spill list.
+ * Otherwise mark it as deleted by setting the LSB. */
+ txn->tw.spill_pages[i] |= 1;
+ if (i == MDBX_PNL_SIZE(txn->tw.spill_pages))
+ MDBX_PNL_SIZE(txn->tw.spill_pages) -= 1;
+ } /* otherwise, if belonging to a parent txn, the
+ * page remains spilled until child commits */
+
+ int rc = mdbx_page_dirty(txn, np);
+ if (likely(rc == MDBX_SUCCESS)) {
+ np->mp_flags |= P_DIRTY;
+ *ret = np;
+ }
+ return rc;
+ }
+ return MDBX_SUCCESS;
+}
+
+/* Touch a page: make it dirty and re-insert into tree with updated pgno.
+ * Set MDBX_TXN_ERROR on failure.
+ *
+ * [in] mc cursor pointing to the page to be touched
+ *
+ * Returns 0 on success, non-zero on failure. */
+__hot static int mdbx_page_touch(MDBX_cursor *mc) {
+ MDBX_page *mp = mc->mc_pg[mc->mc_top], *np;
+ MDBX_txn *txn = mc->mc_txn;
+ MDBX_cursor *m2, *m3;
+ pgno_t pgno;
+ int rc;
+
+ mdbx_cassert(mc, !IS_OVERFLOW(mp));
+ if (!F_ISSET(mp->mp_flags, P_DIRTY)) {
+ if (txn->mt_flags & MDBX_TXN_SPILLS) {
+ np = NULL;
+ rc = mdbx_page_unspill(txn, mp, &np);
+ if (unlikely(rc))
+ goto fail;
+ if (likely(np))
+ goto done;
+ }
+
+ if (unlikely((rc = mdbx_pnl_need(&txn->tw.retired_pages, 1)) ||
+ (rc = mdbx_page_alloc(mc, 1, &np, MDBX_ALLOC_ALL))))
+ goto fail;
+ pgno = np->mp_pgno;
+ mdbx_debug("touched db %d page %" PRIaPGNO " -> %" PRIaPGNO, DDBI(mc),
+ mp->mp_pgno, pgno);
+ mdbx_cassert(mc, mp->mp_pgno != pgno);
+ mdbx_pnl_xappend(txn->tw.retired_pages, mp->mp_pgno);
+ mdbx_tassert(txn, mdbx_dpl_find(txn->tw.dirtylist, mp->mp_pgno) == nullptr);
+ /* Update the parent page, if any, to point to the new page */
+ if (mc->mc_top) {
+ MDBX_page *parent = mc->mc_pg[mc->mc_top - 1];
+ MDBX_node *node = page_node(parent, mc->mc_ki[mc->mc_top - 1]);
+ node_set_pgno(node, pgno);
+ } else {
+ mc->mc_db->md_root = pgno;
+ }
+ } else if (txn->mt_parent && !IS_SUBP(mp)) {
+ mdbx_tassert(txn, (txn->mt_env->me_flags & MDBX_WRITEMAP) == 0);
+ pgno = mp->mp_pgno;
+ /* If txn has a parent, make sure the page is in our dirty list. */
+ const MDBX_page *const dp = mdbx_dpl_find(txn->tw.dirtylist, pgno);
+ if (dp) {
+ if (unlikely(mp != dp)) { /* bad cursor? */
+ mdbx_error("wrong page 0x%p #%" PRIaPGNO
+ " in the dirtylist, expecting %p",
+ __Wpedantic_format_voidptr(dp), pgno,
+ __Wpedantic_format_voidptr(mp));
+ mc->mc_flags &= ~(C_INITIALIZED | C_EOF);
+ rc = MDBX_PROBLEM;
+ goto fail;
+ }
+ return MDBX_SUCCESS;
+ }
+
+ mdbx_debug("clone db %d page %" PRIaPGNO, DDBI(mc), mp->mp_pgno);
+ mdbx_cassert(mc, txn->tw.dirtylist->length <= MDBX_DPL_TXNFULL);
+ /* No - copy it */
+ np = mdbx_page_malloc(txn, 1);
+ if (unlikely(!np)) {
+ rc = MDBX_ENOMEM;
+ goto fail;
+ }
+ rc = mdbx_dpl_append(txn->tw.dirtylist, pgno, np);
+ if (unlikely(rc)) {
+ mdbx_dpage_free(txn->mt_env, np, 1);
+ goto fail;
+ }
+ } else {
+ return MDBX_SUCCESS;
+ }
+
+ mdbx_page_copy(np, mp, txn->mt_env->me_psize);
+ np->mp_pgno = pgno;
+ np->mp_flags |= P_DIRTY;
+
+done:
+ /* Adjust cursors pointing to mp */
+ mc->mc_pg[mc->mc_top] = np;
+ m2 = txn->mt_cursors[mc->mc_dbi];
+ if (mc->mc_flags & C_SUB) {
+ for (; m2; m2 = m2->mc_next) {
+ m3 = &m2->mc_xcursor->mx_cursor;
+ if (m3->mc_snum < mc->mc_snum)
+ continue;
+ if (m3->mc_pg[mc->mc_top] == mp)
+ m3->mc_pg[mc->mc_top] = np;
+ }
+ } else {
+ for (; m2; m2 = m2->mc_next) {
+ if (m2->mc_snum < mc->mc_snum)
+ continue;
+ if (m2 == mc)
+ continue;
+ if (m2->mc_pg[mc->mc_top] == mp) {
+ m2->mc_pg[mc->mc_top] = np;
+ if (XCURSOR_INITED(m2) && IS_LEAF(np))
+ XCURSOR_REFRESH(m2, np, m2->mc_ki[mc->mc_top]);
+ }
+ }
+ }
+ return MDBX_SUCCESS;
+
+fail:
+ txn->mt_flags |= MDBX_TXN_ERROR;
+ return rc;
+}
+
+__cold int mdbx_env_sync_ex(MDBX_env *env, int force, int nonblock) {
+ if (unlikely(!env))
+ return MDBX_EINVAL;
+
+ if (unlikely(env->me_signature != MDBX_ME_SIGNATURE))
+ return MDBX_EBADSIGN;
+
+#if MDBX_TXN_CHECKPID
+ if (unlikely(env->me_pid != mdbx_getpid())) {
+ env->me_flags |= MDBX_FATAL_ERROR;
+ return MDBX_PANIC;
+ }
+#endif /* MDBX_TXN_CHECKPID */
+
+ unsigned flags = env->me_flags & ~MDBX_NOMETASYNC;
+ if (unlikely(flags & (MDBX_RDONLY | MDBX_FATAL_ERROR)))
+ return MDBX_EACCESS;
+
+ if (unlikely(!env->me_map))
+ return MDBX_EPERM;
+
+ int rc = MDBX_RESULT_TRUE /* means "nothing to sync" */;
+ bool need_unlock = false;
+ if (nonblock && *env->me_unsynced_pages == 0)
+ goto fastpath;
+
+ const bool outside_txn = (env->me_txn0->mt_owner != mdbx_thread_self());
+ if (outside_txn) {
+ int err = mdbx_txn_lock(env, nonblock);
+ if (unlikely(err != MDBX_SUCCESS))
+ return err;
+ need_unlock = true;
+ }
+
+ const MDBX_meta *head = mdbx_meta_head(env);
+ pgno_t unsynced_pages = *env->me_unsynced_pages;
+ if (!META_IS_STEADY(head) || unsynced_pages) {
+ const pgno_t autosync_threshold = *env->me_autosync_threshold;
+ const uint64_t autosync_period = *env->me_autosync_period;
+ if (force || (autosync_threshold && unsynced_pages >= autosync_threshold) ||
+ (autosync_period &&
+ mdbx_osal_monotime() - *env->me_sync_timestamp >= autosync_period))
+ flags &= MDBX_WRITEMAP /* clear flags for full steady sync */;
+
+ if (outside_txn) {
+ if (unsynced_pages > /* FIXME: define threshold */ 16 &&
+ (flags & (MDBX_NOSYNC | MDBX_MAPASYNC)) == 0) {
+ mdbx_assert(env, ((flags ^ env->me_flags) & MDBX_WRITEMAP) == 0);
+ const size_t usedbytes = pgno_align2os_bytes(env, head->mm_geo.next);
+
+ mdbx_txn_unlock(env);
+
+ /* LY: pre-sync without holding lock to reduce latency for writer(s) */
+ int err = (flags & MDBX_WRITEMAP)
+ ? mdbx_msync(&env->me_dxb_mmap, 0, usedbytes, false)
+ : mdbx_filesync(env->me_fd, MDBX_SYNC_DATA);
+ if (unlikely(err != MDBX_SUCCESS))
+ return err;
+
+ err = mdbx_txn_lock(env, nonblock);
+ if (unlikely(err != MDBX_SUCCESS))
+ return err;
+
+ /* LY: head and unsynced_pages may be changed. */
+ head = mdbx_meta_head(env);
+ unsynced_pages = *env->me_unsynced_pages;
+ }
+ env->me_txn0->mt_txnid = meta_txnid(env, head, false);
+ mdbx_find_oldest(env->me_txn0);
+ rc = MDBX_RESULT_FALSE /* means "some data was synced" */;
+ }
+
+ if (!META_IS_STEADY(head) ||
+ ((flags & (MDBX_NOSYNC | MDBX_MAPASYNC)) == 0 && unsynced_pages)) {
+ mdbx_debug("meta-head %" PRIaPGNO ", %s, sync_pending %" PRIaPGNO,
+ data_page(head)->mp_pgno, mdbx_durable_str(head),
+ unsynced_pages);
+ MDBX_meta meta = *head;
+ int err = mdbx_sync_locked(env, flags | MDBX_SHRINK_ALLOWED, &meta);
+ if (unlikely(err != MDBX_SUCCESS)) {
+ if (need_unlock)
+ mdbx_txn_unlock(env);
+ return err;
+ }
+ rc = MDBX_RESULT_FALSE /* means "some data was synced" */;
+ }
+ }
+
+fastpath:
+ /* LY: sync meta-pages if MDBX_NOMETASYNC enabled
+ * and someone was not synced above. */
+ if (rc == MDBX_RESULT_TRUE && (env->me_flags & MDBX_NOMETASYNC) != 0) {
+ const txnid_t head_txnid = mdbx_recent_committed_txnid(env);
+ if (*env->me_meta_sync_txnid != (uint32_t)head_txnid) {
+ rc = (flags & MDBX_WRITEMAP)
+ ? mdbx_msync(&env->me_dxb_mmap, 0, pgno2bytes(env, NUM_METAS),
+ false)
+ : mdbx_filesync(env->me_fd, MDBX_SYNC_DATA | MDBX_SYNC_IODQ);
+ if (likely(rc == MDBX_SUCCESS))
+ *env->me_meta_sync_txnid = (uint32_t)head_txnid;
+ }
+ }
+ if (need_unlock)
+ mdbx_txn_unlock(env);
+ return rc;
+}
+
+__cold int mdbx_env_sync(MDBX_env *env) {
+ return mdbx_env_sync_ex(env, true, false);
+}
+
+__cold int mdbx_env_sync_poll(MDBX_env *env) {
+ return mdbx_env_sync_ex(env, false, true);
+}
+
+/* Back up parent txn's cursors, then grab the originals for tracking */
+static int mdbx_cursor_shadow(MDBX_txn *src, MDBX_txn *dst) {
+ MDBX_cursor *mc, *bk;
+ MDBX_xcursor *mx;
+
+ for (int i = src->mt_numdbs; --i >= 0;) {
+ dst->mt_cursors[i] = NULL;
+ if ((mc = src->mt_cursors[i]) != NULL) {
+ size_t size = sizeof(MDBX_cursor);
+ if (mc->mc_xcursor)
+ size += sizeof(MDBX_xcursor);
+ for (; mc; mc = bk->mc_next) {
+ bk = mdbx_malloc(size);
+ if (unlikely(!bk))
+ return MDBX_ENOMEM;
+ *bk = *mc;
+ mc->mc_backup = bk;
+ mc->mc_db = &dst->mt_dbs[i];
+ /* Kill pointers into src to reduce abuse: The
+ * user may not use mc until dst ends. But we need a valid
+ * txn pointer here for cursor fixups to keep working. */
+ mc->mc_txn = dst;
+ mc->mc_dbflag = &dst->mt_dbflags[i];
+ if ((mx = mc->mc_xcursor) != NULL) {
+ *(MDBX_xcursor *)(bk + 1) = *mx;
+ mx->mx_cursor.mc_txn = dst;
+ }
+ mc->mc_next = dst->mt_cursors[i];
+ dst->mt_cursors[i] = mc;
+ }
+ }
+ }
+ return MDBX_SUCCESS;
+}
+
+/* Close this write txn's cursors, give parent txn's cursors back to parent.
+ *
+ * [in] txn the transaction handle.
+ * [in] merge true to keep changes to parent cursors, false to revert.
+ *
+ * Returns 0 on success, non-zero on failure. */
+static void mdbx_cursors_eot(MDBX_txn *txn, unsigned merge) {
+ MDBX_cursor **cursors = txn->mt_cursors, *mc, *next, *bk;
+ MDBX_xcursor *mx;
+ int i;
+
+ for (i = txn->mt_numdbs; --i >= 0;) {
+ for (mc = cursors[i]; mc; mc = next) {
+ unsigned stage = mc->mc_signature;
+ mdbx_ensure(txn->mt_env,
+ stage == MDBX_MC_SIGNATURE || stage == MDBX_MC_WAIT4EOT);
+ next = mc->mc_next;
+ mdbx_tassert(txn, !next || next->mc_signature == MDBX_MC_SIGNATURE ||
+ next->mc_signature == MDBX_MC_WAIT4EOT);
+ if ((bk = mc->mc_backup) != NULL) {
+ if (merge) {
+ /* Commit changes to parent txn */
+ mc->mc_next = bk->mc_next;
+ mc->mc_backup = bk->mc_backup;
+ mc->mc_txn = bk->mc_txn;
+ mc->mc_db = bk->mc_db;
+ mc->mc_dbflag = bk->mc_dbflag;
+ if ((mx = mc->mc_xcursor) != NULL)
+ mx->mx_cursor.mc_txn = bk->mc_txn;
+ } else {
+ /* Abort nested txn */
+ *mc = *bk;
+ if ((mx = mc->mc_xcursor) != NULL)
+ *mx = *(MDBX_xcursor *)(bk + 1);
+ }
+ bk->mc_signature = 0;
+ mdbx_free(bk);
+ }
+ if (stage == MDBX_MC_WAIT4EOT) {
+ mc->mc_signature = 0;
+ mdbx_free(mc);
+ } else {
+ mc->mc_signature = MDBX_MC_READY4CLOSE;
+ mc->mc_flags = 0 /* reset C_UNTRACK */;
+ }
+ }
+ cursors[i] = NULL;
+ }
+}
+
+#if defined(MDBX_USE_VALGRIND) || defined(__SANITIZE_ADDRESS__)
+/* Find largest mvcc-snapshot still referenced by this process. */
+static pgno_t mdbx_find_largest_this(MDBX_env *env, pgno_t largest) {
+ MDBX_lockinfo *const lck = env->me_lck;
+ if (likely(lck != NULL /* exclusive mode */)) {
+ const unsigned snap_nreaders = lck->mti_numreaders;
+ for (unsigned i = 0; i < snap_nreaders; ++i) {
+ retry:
+ if (lck->mti_readers[i].mr_pid == env->me_pid) {
+ /* mdbx_jitter4testing(true); */
+ const pgno_t snap_pages = lck->mti_readers[i].mr_snapshot_pages_used;
+ const txnid_t snap_txnid = safe64_read(&lck->mti_readers[i].mr_txnid);
+ mdbx_memory_barrier();
+ if (unlikely(snap_pages != lck->mti_readers[i].mr_snapshot_pages_used ||
+ snap_txnid != safe64_read(&lck->mti_readers[i].mr_txnid)))
+ goto retry;
+ if (largest < snap_pages &&
+ lck->mti_oldest_reader <= /* ignore pending updates */ snap_txnid &&
+ snap_txnid < SAFE64_INVALID_THRESHOLD)
+ largest = snap_pages;
+ }
+ }
+ }
+ return largest;
+}
+
+static void mdbx_txn_valgrind(MDBX_env *env, MDBX_txn *txn) {
+#if !defined(__SANITIZE_ADDRESS__)
+ if (!RUNNING_ON_VALGRIND)
+ return;
+#endif
+
+ if (txn) { /* transaction start */
+ if (env->me_poison_edge < txn->mt_next_pgno)
+ env->me_poison_edge = txn->mt_next_pgno;
+ VALGRIND_MAKE_MEM_DEFINED(env->me_map, pgno2bytes(env, txn->mt_next_pgno));
+ ASAN_UNPOISON_MEMORY_REGION(env->me_map,
+ pgno2bytes(env, txn->mt_next_pgno));
+ /* don't touch more, it should be already poisoned */
+ } else { /* transaction end */
+ bool should_unlock = false;
+ pgno_t last = MAX_PAGENO;
+ if (env->me_txn0 && env->me_txn0->mt_owner == mdbx_thread_self()) {
+ /* inside write-txn */
+ MDBX_meta *head = mdbx_meta_head(env);
+ last = head->mm_geo.next;
+ } else if (mdbx_txn_lock(env, true) == MDBX_SUCCESS) {
+ /* no write-txn */
+ last = NUM_METAS;
+ should_unlock = true;
+ } else {
+ /* write txn is running, therefore shouldn't poison any memory range */
+ return;
+ }
+
+ last = mdbx_find_largest_this(env, last);
+ const pgno_t edge = env->me_poison_edge;
+ if (edge > last) {
+ mdbx_assert(env, last >= NUM_METAS);
+ env->me_poison_edge = last;
+ VALGRIND_MAKE_MEM_NOACCESS(env->me_map + pgno2bytes(env, last),
+ pgno2bytes(env, edge - last));
+ ASAN_POISON_MEMORY_REGION(env->me_map + pgno2bytes(env, last),
+ pgno2bytes(env, edge - last));
+ }
+ if (should_unlock)
+ mdbx_txn_unlock(env);
+ }
+}
+#endif /* MDBX_USE_VALGRIND */
+
+/* Common code for mdbx_txn_begin() and mdbx_txn_renew(). */
+static int mdbx_txn_renew0(MDBX_txn *txn, unsigned flags) {
+ MDBX_env *env = txn->mt_env;
+ int rc;
+
+#if MDBX_TXN_CHECKPID
+ if (unlikely(env->me_pid != mdbx_getpid())) {
+ env->me_flags |= MDBX_FATAL_ERROR;
+ return MDBX_PANIC;
+ }
+#endif /* MDBX_TXN_CHECKPID */
+
+ STATIC_ASSERT(sizeof(MDBX_reader) == 32);
+#ifdef MDBX_OSAL_LOCK
+ STATIC_ASSERT(offsetof(MDBX_lockinfo, mti_wmutex) % MDBX_CACHELINE_SIZE == 0);
+ STATIC_ASSERT(offsetof(MDBX_lockinfo, mti_rmutex) % MDBX_CACHELINE_SIZE == 0);
+#else
+ STATIC_ASSERT(
+ offsetof(MDBX_lockinfo, mti_oldest_reader) % MDBX_CACHELINE_SIZE == 0);
+ STATIC_ASSERT(offsetof(MDBX_lockinfo, mti_numreaders) % MDBX_CACHELINE_SIZE ==
+ 0);
+#endif
+ STATIC_ASSERT(offsetof(MDBX_lockinfo, mti_readers) % MDBX_CACHELINE_SIZE ==
+ 0);
+
+ if (flags & MDBX_RDONLY) {
+ txn->mt_flags = MDBX_RDONLY | (env->me_flags & MDBX_NOTLS);
+ MDBX_reader *r = txn->to.reader;
+ STATIC_ASSERT(sizeof(size_t) == sizeof(r->mr_tid));
+ if (likely(env->me_flags & MDBX_ENV_TXKEY)) {
+ mdbx_assert(env, !(env->me_flags & MDBX_NOTLS));
+ r = thread_rthc_get(env->me_txkey);
+ if (likely(r)) {
+ mdbx_assert(env, r->mr_pid == env->me_pid);
+ mdbx_assert(env, r->mr_tid == mdbx_thread_self());
+ }
+ } else {
+ mdbx_assert(env, !env->me_lck || (env->me_flags & MDBX_NOTLS));
+ }
+
+ if (likely(r)) {
+ if (unlikely(r->mr_pid != env->me_pid ||
+ r->mr_txnid.inconsistent < SAFE64_INVALID_THRESHOLD))
+ return MDBX_BAD_RSLOT;
+ } else if (env->me_lck) {
+ unsigned slot, nreaders;
+ const size_t tid = mdbx_thread_self();
+ mdbx_assert(env, env->me_lck->mti_magic_and_version == MDBX_LOCK_MAGIC);
+ mdbx_assert(env, env->me_lck->mti_os_and_format == MDBX_LOCK_FORMAT);
+
+ rc = mdbx_rdt_lock(env);
+ if (unlikely(MDBX_IS_ERROR(rc)))
+ return rc;
+ if (unlikely(env->me_flags & MDBX_FATAL_ERROR)) {
+ mdbx_rdt_unlock(env);
+ return MDBX_PANIC;
+ }
+#if defined(_WIN32) || defined(_WIN64)
+ if (unlikely(!env->me_map)) {
+ mdbx_rdt_unlock(env);
+ return MDBX_EPERM;
+ }
+#endif /* Windows */
+ rc = MDBX_SUCCESS;
+
+ if (unlikely(env->me_live_reader != env->me_pid)) {
+ rc = mdbx_rpid_set(env);
+ if (unlikely(rc != MDBX_SUCCESS)) {
+ mdbx_rdt_unlock(env);
+ return rc;
+ }
+ env->me_live_reader = env->me_pid;
+ }
+
+ while (1) {
+ nreaders = env->me_lck->mti_numreaders;
+ for (slot = 0; slot < nreaders; slot++)
+ if (env->me_lck->mti_readers[slot].mr_pid == 0)
+ break;
+
+ if (likely(slot < env->me_maxreaders))
+ break;
+
+ rc = mdbx_reader_check0(env, true, NULL);
+ if (rc != MDBX_RESULT_TRUE) {
+ mdbx_rdt_unlock(env);
+ return (rc == MDBX_SUCCESS) ? MDBX_READERS_FULL : rc;
+ }
+ }
+
+ r = &env->me_lck->mti_readers[slot];
+ /* Claim the reader slot, carefully since other code
+ * uses the reader table un-mutexed: First reset the
+ * slot, next publish it in lck->mti_numreaders. After
+ * that, it is safe for mdbx_env_close() to touch it.
+ * When it will be closed, we can finally claim it. */
+ r->mr_pid = 0;
+ safe64_reset(&r->mr_txnid, true);
+ if (slot == nreaders)
+ env->me_lck->mti_numreaders = ++nreaders;
+ r->mr_tid = tid;
+ r->mr_pid = env->me_pid;
+ mdbx_rdt_unlock(env);
+
+ if (likely(env->me_flags & MDBX_ENV_TXKEY)) {
+ mdbx_assert(env, env->me_live_reader == env->me_pid);
+ thread_rthc_set(env->me_txkey, r);
+ }
+ }
+
+ while (1) {
+ MDBX_meta *const meta = mdbx_meta_head(env);
+ mdbx_jitter4testing(false);
+ const txnid_t snap = mdbx_meta_txnid_fluid(env, meta);
+ mdbx_jitter4testing(false);
+ if (likely(r)) {
+ safe64_reset(&r->mr_txnid, false);
+ r->mr_snapshot_pages_used = meta->mm_geo.next;
+ r->mr_snapshot_pages_retired = meta->mm_pages_retired;
+ safe64_write(&r->mr_txnid, snap);
+ mdbx_jitter4testing(false);
+ mdbx_assert(env, r->mr_pid == mdbx_getpid());
+ mdbx_assert(env, r->mr_tid == mdbx_thread_self());
+ mdbx_assert(env, r->mr_txnid.inconsistent == snap);
+ mdbx_compiler_barrier();
+ env->me_lck->mti_readers_refresh_flag = true;
+ mdbx_flush_noncoherent_cpu_writeback();
+ }
+ mdbx_jitter4testing(true);
+
+ /* Snap the state from current meta-head */
+ txn->mt_txnid = snap;
+ txn->mt_geo = meta->mm_geo;
+ memcpy(txn->mt_dbs, meta->mm_dbs, CORE_DBS * sizeof(MDBX_db));
+ txn->mt_canary = meta->mm_canary;
+
+ /* LY: Retry on a race, ITS#7970. */
+ mdbx_compiler_barrier();
+ if (likely(meta == mdbx_meta_head(env) &&
+ snap == mdbx_meta_txnid_fluid(env, meta) &&
+ snap >= *env->me_oldest)) {
+ mdbx_jitter4testing(false);
+ break;
+ }
+ }
+
+ if (unlikely(txn->mt_txnid == 0 ||
+ txn->mt_txnid >= SAFE64_INVALID_THRESHOLD)) {
+ mdbx_error("%s", "environment corrupted by died writer, must shutdown!");
+ rc = MDBX_WANNA_RECOVERY;
+ goto bailout;
+ }
+ mdbx_assert(env, txn->mt_txnid >= *env->me_oldest);
+ txn->to.reader = r;
+ txn->mt_dbxs = env->me_dbxs; /* mostly static anyway */
+ mdbx_ensure(env, txn->mt_txnid >=
+ /* paranoia is appropriate here */ *env->me_oldest);
+ } else {
+ /* Not yet touching txn == env->me_txn0, it may be active */
+ mdbx_jitter4testing(false);
+ rc = mdbx_txn_lock(env, F_ISSET(flags, MDBX_TRYTXN));
+ if (unlikely(rc))
+ return rc;
+ if (unlikely(env->me_flags & MDBX_FATAL_ERROR)) {
+ mdbx_txn_unlock(env);
+ return MDBX_PANIC;
+ }
+#if defined(_WIN32) || defined(_WIN64)
+ if (unlikely(!env->me_map)) {
+ mdbx_txn_unlock(env);
+ return MDBX_EPERM;
+ }
+#endif /* Windows */
+
+ mdbx_jitter4testing(false);
+ MDBX_meta *meta = mdbx_meta_head(env);
+ mdbx_jitter4testing(false);
+ txn->mt_canary = meta->mm_canary;
+ const txnid_t snap = mdbx_meta_txnid_stable(env, meta);
+ txn->mt_txnid = safe64_txnid_next(snap);
+ if (unlikely(txn->mt_txnid >= SAFE64_INVALID_THRESHOLD)) {
+ mdbx_debug("%s", "txnid overflow!");
+ rc = MDBX_TXN_FULL;
+ goto bailout;
+ }
+
+ txn->mt_flags = flags;
+ txn->mt_child = NULL;
+ txn->tw.loose_pages = NULL;
+ txn->tw.loose_count = 0;
+ txn->tw.dirtyroom = MDBX_DPL_TXNFULL;
+ txn->tw.dirtylist = env->me_dirtylist;
+ mdbx_dpl_clear(txn->tw.dirtylist);
+ MDBX_PNL_SIZE(txn->tw.retired_pages) = 0;
+ txn->tw.spill_pages = NULL;
+ txn->tw.last_reclaimed = 0;
+ if (txn->tw.lifo_reclaimed)
+ MDBX_PNL_SIZE(txn->tw.lifo_reclaimed) = 0;
+ env->me_txn = txn;
+ memcpy(txn->mt_dbiseqs, env->me_dbiseqs, env->me_maxdbs * sizeof(unsigned));
+ /* Copy the DB info and flags */
+ memcpy(txn->mt_dbs, meta->mm_dbs, CORE_DBS * sizeof(MDBX_db));
+ /* Moved to here to avoid a data race in read TXNs */
+ txn->mt_geo = meta->mm_geo;
+ txn->tw.loose_refund_wl = txn->mt_next_pgno;
+ }
+
+ /* Setup db info */
+ txn->mt_numdbs = env->me_numdbs;
+ mdbx_compiler_barrier();
+ for (unsigned i = CORE_DBS; i < txn->mt_numdbs; i++) {
+ unsigned x = env->me_dbflags[i];
+ txn->mt_dbs[i].md_flags = x & PERSISTENT_FLAGS;
+ txn->mt_dbflags[i] =
+ (x & MDBX_VALID) ? DB_VALID | DB_USRVALID | DB_STALE : 0;
+ }
+ txn->mt_dbflags[MAIN_DBI] = DB_VALID | DB_USRVALID;
+ txn->mt_dbflags[FREE_DBI] = DB_VALID;
+
+ if (unlikely(env->me_flags & MDBX_FATAL_ERROR)) {
+ mdbx_warning("%s", "environment had fatal error, must shutdown!");
+ rc = MDBX_PANIC;
+ } else {
+ const size_t size = pgno2bytes(env, txn->mt_end_pgno);
+ if (unlikely(size > env->me_dxb_mmap.limit)) {
+ if (txn->mt_geo.upper > MAX_PAGENO ||
+ bytes2pgno(env, pgno2bytes(env, txn->mt_geo.upper)) !=
+ txn->mt_geo.upper) {
+ rc = MDBX_MAP_RESIZED;
+ goto bailout;
+ }
+ rc = mdbx_mapresize(env, txn->mt_end_pgno, txn->mt_geo.upper);
+ if (rc != MDBX_SUCCESS) {
+ if (rc == MDBX_RESULT_TRUE)
+ rc = MDBX_MAP_RESIZED;
+ goto bailout;
+ }
+ }
+ if (txn->mt_flags & MDBX_RDONLY) {
+#if defined(_WIN32) || defined(_WIN64)
+ if (size > env->me_dbgeo.lower && env->me_dbgeo.shrink) {
+ txn->mt_flags |= MDBX_SHRINK_ALLOWED;
+ mdbx_srwlock_AcquireShared(&env->me_remap_guard);
+ }
+#endif
+ } else {
+ env->me_dxb_mmap.current = size;
+ }
+#if defined(MDBX_USE_VALGRIND) || defined(__SANITIZE_ADDRESS__)
+ mdbx_txn_valgrind(env, txn);
+#endif
+ txn->mt_owner = mdbx_thread_self();
+ return MDBX_SUCCESS;
+ }
+bailout:
+ mdbx_tassert(txn, rc != MDBX_SUCCESS);
+ mdbx_txn_end(txn, MDBX_END_SLOT | MDBX_END_FAIL_BEGIN);
+ return rc;
+}
+
+static __always_inline int check_txn(const MDBX_txn *txn, int bad_bits) {
+ if (unlikely(!txn))
+ return MDBX_EINVAL;
+
+ if (unlikely(txn->mt_signature != MDBX_MT_SIGNATURE))
+ return MDBX_EBADSIGN;
+
+ if (unlikely(txn->mt_flags & bad_bits))
+ return MDBX_BAD_TXN;
+
+#if MDBX_TXN_CHECKOWNER
+ if ((txn->mt_flags & MDBX_NOTLS) == 0 &&
+ unlikely(txn->mt_owner != mdbx_thread_self()))
+ return txn->mt_owner ? MDBX_THREAD_MISMATCH : MDBX_BAD_TXN;
+#endif /* MDBX_TXN_CHECKOWNER */
+
+ return MDBX_SUCCESS;
+}
+
+static __always_inline int check_txn_rw(const MDBX_txn *txn, int bad_bits) {
+ if (unlikely(!txn))
+ return MDBX_EINVAL;
+
+ if (unlikely(txn->mt_signature != MDBX_MT_SIGNATURE))
+ return MDBX_EBADSIGN;
+
+ if (unlikely(txn->mt_flags & bad_bits))
+ return MDBX_BAD_TXN;
+
+ if (unlikely(F_ISSET(txn->mt_flags, MDBX_RDONLY)))
+ return MDBX_EACCESS;
+
+#if MDBX_TXN_CHECKOWNER
+ if (unlikely(txn->mt_owner != mdbx_thread_self()))
+ return txn->mt_owner ? MDBX_THREAD_MISMATCH : MDBX_BAD_TXN;
+#endif /* MDBX_TXN_CHECKOWNER */
+
+ return MDBX_SUCCESS;
+}
+
+int mdbx_txn_renew(MDBX_txn *txn) {
+ int rc;
+
+ if (unlikely(!txn))
+ return MDBX_EINVAL;
+
+ if (unlikely(txn->mt_signature != MDBX_MT_SIGNATURE))
+ return MDBX_EBADSIGN;
+
+ if (unlikely((txn->mt_flags & MDBX_RDONLY) == 0))
+ return MDBX_EINVAL;
+
+ if (unlikely(txn->mt_owner != 0))
+ return MDBX_THREAD_MISMATCH;
+
+ rc = mdbx_txn_renew0(txn, MDBX_RDONLY);
+ if (rc == MDBX_SUCCESS) {
+ txn->mt_owner = mdbx_thread_self();
+ mdbx_debug("renew txn %" PRIaTXN "%c %p on env %p, root page %" PRIaPGNO
+ "/%" PRIaPGNO,
+ txn->mt_txnid, (txn->mt_flags & MDBX_RDONLY) ? 'r' : 'w',
+ (void *)txn, (void *)txn->mt_env, txn->mt_dbs[MAIN_DBI].md_root,
+ txn->mt_dbs[FREE_DBI].md_root);
+ }
+ return rc;
+}
+
+int mdbx_txn_begin(MDBX_env *env, MDBX_txn *parent, unsigned flags,
+ MDBX_txn **ret) {
+ MDBX_txn *txn;
+ int rc;
+ unsigned size, tsize;
+
+ if (unlikely(!ret))
+ return MDBX_EINVAL;
+ *ret = NULL;
+
+ if (unlikely(!env))
+ return MDBX_EINVAL;
+ if (unlikely(env->me_signature != MDBX_ME_SIGNATURE))
+ return MDBX_EBADSIGN;
+
+#if MDBX_TXN_CHECKPID
+ if (unlikely(env->me_pid != mdbx_getpid()))
+ env->me_flags |= MDBX_FATAL_ERROR;
+#endif /* MDBX_TXN_CHECKPID */
+
+ if (unlikely(env->me_flags & MDBX_FATAL_ERROR))
+ return MDBX_PANIC;
+
+#if !defined(_WIN32) && !defined(_WIN64)
+ /* Don't check env->me_map until lock to
+ * avoid race with re-mapping for shrinking */
+ if (unlikely(!env->me_map))
+ return MDBX_EPERM;
+#endif /* Windows */
+
+ if (unlikely(flags & ~MDBX_TXN_BEGIN_FLAGS))
+ return MDBX_EINVAL;
+
+ if (unlikely(env->me_flags & MDBX_RDONLY &
+ ~flags)) /* write txn in RDONLY env */
+ return MDBX_EACCESS;
+
+ flags |= env->me_flags & MDBX_WRITEMAP;
+
+ if (parent) {
+ /* Nested transactions: Max 1 child, write txns only, no writemap */
+ rc = check_txn_rw(parent, MDBX_RDONLY | MDBX_WRITEMAP | MDBX_TXN_BLOCKED);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+#if defined(_WIN32) || defined(_WIN64)
+ if (unlikely(!env->me_map))
+ return MDBX_EPERM;
+#endif /* Windows */
+
+ flags |= parent->mt_flags &
+ (MDBX_TXN_BEGIN_FLAGS | MDBX_SHRINK_ALLOWED | MDBX_TXN_SPILLS);
+ /* Child txns save MDBX_pgstate and use own copy of cursors */
+ size = env->me_maxdbs * (sizeof(MDBX_db) + sizeof(MDBX_cursor *) + 1);
+ size += tsize = sizeof(MDBX_txn);
+ } else if (flags & MDBX_RDONLY) {
+ if (env->me_txn0 && unlikely(env->me_txn0->mt_owner == mdbx_thread_self()))
+ return MDBX_BUSY;
+ size = env->me_maxdbs * (sizeof(MDBX_db) + 1);
+ size += tsize = sizeof(MDBX_txn);
+ } else {
+ /* Reuse preallocated write txn. However, do not touch it until
+ * mdbx_txn_renew0() succeeds, since it currently may be active. */
+ txn = env->me_txn0;
+ if (unlikely(txn->mt_owner == mdbx_thread_self()))
+ return MDBX_BUSY;
+ goto renew;
+ }
+ if (unlikely((txn = mdbx_malloc(size)) == NULL)) {
+ mdbx_debug("calloc: %s", "failed");
+ return MDBX_ENOMEM;
+ }
+ memset(txn, 0, tsize);
+ txn->mt_dbxs = env->me_dbxs; /* static */
+ txn->mt_dbs = (MDBX_db *)((char *)txn + tsize);
+ txn->mt_dbflags = (uint8_t *)txn + size - env->me_maxdbs;
+ txn->mt_flags = flags;
+ txn->mt_env = env;
+
+ if (parent) {
+ mdbx_tassert(txn, mdbx_dirtylist_check(parent));
+ txn->mt_cursors = (MDBX_cursor **)(txn->mt_dbs + env->me_maxdbs);
+ txn->mt_dbiseqs = parent->mt_dbiseqs;
+ txn->tw.dirtylist = mdbx_malloc(sizeof(MDBX_DP) * (MDBX_DPL_TXNFULL + 1));
+ txn->tw.reclaimed_pglist =
+ mdbx_pnl_alloc(MDBX_PNL_ALLOCLEN(parent->tw.reclaimed_pglist));
+ if (!txn->tw.dirtylist || !txn->tw.reclaimed_pglist) {
+ mdbx_pnl_free(txn->tw.reclaimed_pglist);
+ mdbx_free(txn->tw.dirtylist);
+ mdbx_free(txn);
+ return MDBX_ENOMEM;
+ }
+ mdbx_dpl_clear(txn->tw.dirtylist);
+ memcpy(txn->tw.reclaimed_pglist, parent->tw.reclaimed_pglist,
+ MDBX_PNL_SIZEOF(parent->tw.reclaimed_pglist));
+ mdbx_assert(env, mdbx_pnl_check4assert(
+ txn->tw.reclaimed_pglist,
+ (txn->mt_next_pgno /* LY: intentional assigment here,
+ only for assertion */
+ = parent->mt_next_pgno)));
+
+ txn->tw.last_reclaimed = parent->tw.last_reclaimed;
+ if (parent->tw.lifo_reclaimed) {
+ txn->tw.lifo_reclaimed = parent->tw.lifo_reclaimed;
+ parent->tw.lifo_reclaimed =
+ (void *)(intptr_t)MDBX_PNL_SIZE(parent->tw.lifo_reclaimed);
+ }
+
+ txn->tw.retired_pages = parent->tw.retired_pages;
+ parent->tw.retired_pages =
+ (void *)(intptr_t)MDBX_PNL_SIZE(parent->tw.retired_pages);
+
+ txn->mt_txnid = parent->mt_txnid;
+ txn->tw.dirtyroom = parent->tw.dirtyroom;
+ txn->mt_geo = parent->mt_geo;
+ txn->tw.loose_refund_wl = parent->tw.loose_refund_wl;
+ txn->mt_canary = parent->mt_canary;
+ parent->mt_flags |= MDBX_TXN_HAS_CHILD;
+ parent->mt_child = txn;
+ txn->mt_parent = parent;
+ txn->mt_numdbs = parent->mt_numdbs;
+ txn->mt_owner = parent->mt_owner;
+ memcpy(txn->mt_dbs, parent->mt_dbs, txn->mt_numdbs * sizeof(MDBX_db));
+ /* Copy parent's mt_dbflags, but clear DB_NEW */
+ for (unsigned i = 0; i < txn->mt_numdbs; i++)
+ txn->mt_dbflags[i] = parent->mt_dbflags[i] & ~(DB_FRESH | DB_CREAT);
+ mdbx_tassert(parent,
+ parent->mt_parent ||
+ parent->tw.dirtyroom + parent->tw.dirtylist->length ==
+ MDBX_DPL_TXNFULL);
+ env->me_txn = txn;
+ rc = mdbx_cursor_shadow(parent, txn);
+ if (unlikely(rc != MDBX_SUCCESS))
+ mdbx_txn_end(txn, MDBX_END_FAIL_BEGINCHILD);
+ } else { /* MDBX_RDONLY */
+ txn->mt_dbiseqs = env->me_dbiseqs;
+ renew:
+ rc = mdbx_txn_renew0(txn, flags);
+ }
+
+ if (unlikely(rc != MDBX_SUCCESS)) {
+ if (txn != env->me_txn0)
+ mdbx_free(txn);
+ } else {
+ mdbx_assert(env, (txn->mt_flags &
+ ~(MDBX_RDONLY | MDBX_WRITEMAP | MDBX_SHRINK_ALLOWED |
+ MDBX_NOMETASYNC | MDBX_NOSYNC | MDBX_MAPASYNC)) == 0);
+ txn->mt_signature = MDBX_MT_SIGNATURE;
+ *ret = txn;
+ mdbx_debug("begin txn %" PRIaTXN "%c %p on env %p, root page %" PRIaPGNO
+ "/%" PRIaPGNO,
+ txn->mt_txnid, (flags & MDBX_RDONLY) ? 'r' : 'w', (void *)txn,
+ (void *)env, txn->mt_dbs[MAIN_DBI].md_root,
+ txn->mt_dbs[FREE_DBI].md_root);
+ }
+
+ return rc;
+}
+
+int mdbx_txn_info(MDBX_txn *txn, MDBX_txn_info *info, int scan_rlt) {
+ int rc = check_txn(txn, MDBX_TXN_BLOCKED - MDBX_TXN_HAS_CHILD);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ if (unlikely(!info))
+ return MDBX_EINVAL;
+
+ MDBX_env *const env = txn->mt_env;
+#if MDBX_TXN_CHECKPID
+ if (unlikely(env->me_pid != mdbx_getpid())) {
+ env->me_flags |= MDBX_FATAL_ERROR;
+ return MDBX_PANIC;
+ }
+#endif /* MDBX_TXN_CHECKPID */
+
+ info->txn_id = txn->mt_txnid;
+ info->txn_space_used = pgno2bytes(env, txn->mt_geo.next);
+
+ if (txn->mt_flags & MDBX_RDONLY) {
+ const MDBX_meta *head_meta;
+ txnid_t head_txnid;
+ uint64_t head_retired;
+ do {
+ /* fetch info from volatile head */
+ head_meta = mdbx_meta_head(env);
+ head_txnid = mdbx_meta_txnid_fluid(env, head_meta);
+ head_retired = head_meta->mm_pages_retired;
+ info->txn_space_limit_soft = pgno2bytes(env, head_meta->mm_geo.now);
+ info->txn_space_limit_hard = pgno2bytes(env, head_meta->mm_geo.upper);
+ info->txn_space_leftover =
+ pgno2bytes(env, head_meta->mm_geo.now - head_meta->mm_geo.next);
+ mdbx_compiler_barrier();
+ } while (unlikely(head_meta != mdbx_meta_head(env) ||
+ head_txnid != mdbx_meta_txnid_fluid(env, head_meta)));
+
+ info->txn_reader_lag = head_txnid - info->txn_id;
+ info->txn_space_dirty = info->txn_space_retired = 0;
+ if (txn->to.reader &&
+ head_retired > txn->to.reader->mr_snapshot_pages_retired) {
+ info->txn_space_dirty = info->txn_space_retired =
+ pgno2bytes(env, (pgno_t)(head_retired -
+ txn->to.reader->mr_snapshot_pages_retired));
+
+ size_t retired_next_reader = 0;
+ MDBX_lockinfo *const lck = env->me_lck;
+ if (scan_rlt && info->txn_reader_lag > 1 && lck) {
+ /* find next more recent reader */
+ txnid_t next_reader = head_txnid;
+ const unsigned snap_nreaders = lck->mti_numreaders;
+ for (unsigned i = 0; i < snap_nreaders; ++i) {
+ retry:
+ if (lck->mti_readers[i].mr_pid) {
+ mdbx_jitter4testing(true);
+ const txnid_t snap_txnid =
+ safe64_read(&lck->mti_readers[i].mr_txnid);
+ const uint64_t snap_retired =
+ lck->mti_readers[i].mr_snapshot_pages_retired;
+ mdbx_compiler_barrier();
+ if (unlikely(snap_retired !=
+ lck->mti_readers[i].mr_snapshot_pages_retired) ||
+ snap_txnid != safe64_read(&lck->mti_readers[i].mr_txnid))
+ goto retry;
+ if (snap_txnid <= txn->mt_txnid) {
+ retired_next_reader = 0;
+ break;
+ }
+ if (snap_txnid < next_reader) {
+ next_reader = snap_txnid;
+ retired_next_reader = pgno2bytes(
+ env, (pgno_t)(snap_retired -
+ txn->to.reader->mr_snapshot_pages_retired));
+ }
+ }
+ }
+ }
+ info->txn_space_dirty = retired_next_reader;
+ }
+ } else {
+ info->txn_space_limit_soft = pgno2bytes(env, txn->mt_geo.now);
+ info->txn_space_limit_hard = pgno2bytes(env, txn->mt_geo.upper);
+ info->txn_space_retired = pgno2bytes(
+ env, txn->mt_child ? (unsigned)(uintptr_t)txn->tw.retired_pages
+ : MDBX_PNL_SIZE(txn->tw.retired_pages));
+ info->txn_space_leftover = pgno2bytes(env, txn->tw.dirtyroom);
+ info->txn_space_dirty =
+ pgno2bytes(env, MDBX_DPL_TXNFULL - txn->tw.dirtyroom);
+ info->txn_reader_lag = INT64_MAX;
+ MDBX_lockinfo *const lck = env->me_lck;
+ if (scan_rlt && lck) {
+ txnid_t oldest_snapshot = txn->mt_txnid;
+ const unsigned snap_nreaders = lck->mti_numreaders;
+ if (snap_nreaders) {
+ oldest_snapshot = mdbx_find_oldest(txn);
+ if (oldest_snapshot == txn->mt_txnid - 1) {
+ /* check if there is at least one reader */
+ bool exists = false;
+ for (unsigned i = 0; i < snap_nreaders; ++i) {
+ if (lck->mti_readers[i].mr_pid &&
+ txn->mt_txnid > safe64_read(&lck->mti_readers[i].mr_txnid)) {
+ exists = true;
+ break;
+ }
+ }
+ oldest_snapshot += !exists;
+ }
+ }
+ info->txn_reader_lag = txn->mt_txnid - oldest_snapshot;
+ }
+ }
+
+ return MDBX_SUCCESS;
+}
+
+MDBX_env *mdbx_txn_env(MDBX_txn *txn) {
+ if (unlikely(!txn || txn->mt_signature != MDBX_MT_SIGNATURE ||
+ txn->mt_env->me_signature != MDBX_ME_SIGNATURE))
+ return NULL;
+ return txn->mt_env;
+}
+
+uint64_t mdbx_txn_id(MDBX_txn *txn) {
+ if (unlikely(!txn || txn->mt_signature != MDBX_MT_SIGNATURE))
+ return 0;
+ return txn->mt_txnid;
+}
+
+int mdbx_txn_flags(MDBX_txn *txn) {
+ if (unlikely(!txn || txn->mt_signature != MDBX_MT_SIGNATURE))
+ return -1;
+ return txn->mt_flags;
+}
+
+/* Export or close DBI handles opened in this txn. */
+static void mdbx_dbis_update(MDBX_txn *txn, int keep) {
+ MDBX_dbi n = txn->mt_numdbs;
+ if (n) {
+ bool locked = false;
+ MDBX_env *env = txn->mt_env;
+ uint8_t *tdbflags = txn->mt_dbflags;
+
+ for (unsigned i = n; --i >= CORE_DBS;) {
+ if (likely((tdbflags[i] & DB_CREAT) == 0))
+ continue;
+ if (!locked) {
+ mdbx_ensure(env,
+ mdbx_fastmutex_acquire(&env->me_dbi_lock) == MDBX_SUCCESS);
+ locked = true;
+ }
+ if (keep) {
+ env->me_dbflags[i] = txn->mt_dbs[i].md_flags | MDBX_VALID;
+ mdbx_compiler_barrier();
+ if (env->me_numdbs <= i)
+ env->me_numdbs = i + 1;
+ } else {
+ char *ptr = env->me_dbxs[i].md_name.iov_base;
+ if (ptr) {
+ env->me_dbxs[i].md_name.iov_len = 0;
+ mdbx_compiler_barrier();
+ mdbx_assert(env, env->me_dbflags[i] == 0);
+ env->me_dbiseqs[i]++;
+ env->me_dbxs[i].md_name.iov_base = NULL;
+ mdbx_free(ptr);
+ }
+ }
+ }
+
+ if (unlikely(locked))
+ mdbx_ensure(env,
+ mdbx_fastmutex_release(&env->me_dbi_lock) == MDBX_SUCCESS);
+ }
+}
+
+/* End a transaction, except successful commit of a nested transaction.
+ * May be called twice for readonly txns: First reset it, then abort.
+ * [in] txn the transaction handle to end
+ * [in] mode why and how to end the transaction */
+static int mdbx_txn_end(MDBX_txn *txn, unsigned mode) {
+ MDBX_env *env = txn->mt_env;
+ static const char *const names[] = MDBX_END_NAMES;
+
+#if MDBX_TXN_CHECKPID
+ if (unlikely(txn->mt_env->me_pid != mdbx_getpid())) {
+ env->me_flags |= MDBX_FATAL_ERROR;
+ return MDBX_PANIC;
+ }
+#endif /* MDBX_TXN_CHECKPID */
+
+ mdbx_debug("%s txn %" PRIaTXN "%c %p on mdbenv %p, root page %" PRIaPGNO
+ "/%" PRIaPGNO,
+ names[mode & MDBX_END_OPMASK], txn->mt_txnid,
+ (txn->mt_flags & MDBX_RDONLY) ? 'r' : 'w', (void *)txn,
+ (void *)env, txn->mt_dbs[MAIN_DBI].md_root,
+ txn->mt_dbs[FREE_DBI].md_root);
+
+ mdbx_ensure(env, txn->mt_txnid >=
+ /* paranoia is appropriate here */ *env->me_oldest);
+
+ int rc = MDBX_SUCCESS;
+ if (F_ISSET(txn->mt_flags, MDBX_RDONLY)) {
+ if (txn->to.reader) {
+ MDBX_reader *slot = txn->to.reader;
+ mdbx_assert(env, slot->mr_pid == env->me_pid);
+ if (likely(!F_ISSET(txn->mt_flags, MDBX_TXN_FINISHED))) {
+ mdbx_assert(env, txn->mt_txnid == slot->mr_txnid.inconsistent &&
+ slot->mr_txnid.inconsistent >=
+ env->me_lck->mti_oldest_reader);
+#if defined(MDBX_USE_VALGRIND) || defined(__SANITIZE_ADDRESS__)
+ mdbx_txn_valgrind(env, nullptr);
+#endif
+ slot->mr_snapshot_pages_used = 0;
+ safe64_reset(&slot->mr_txnid, false);
+ env->me_lck->mti_readers_refresh_flag = true;
+ mdbx_flush_noncoherent_cpu_writeback();
+ } else {
+ mdbx_assert(env, slot->mr_pid == env->me_pid);
+ mdbx_assert(env,
+ slot->mr_txnid.inconsistent >= SAFE64_INVALID_THRESHOLD);
+ }
+ if (mode & MDBX_END_SLOT) {
+ if ((env->me_flags & MDBX_ENV_TXKEY) == 0)
+ slot->mr_pid = 0;
+ txn->to.reader = NULL;
+ }
+ }
+#if defined(_WIN32) || defined(_WIN64)
+ if (txn->mt_flags & MDBX_SHRINK_ALLOWED)
+ mdbx_srwlock_ReleaseShared(&env->me_remap_guard);
+#endif
+ txn->mt_numdbs = 0; /* prevent further DBI activity */
+ txn->mt_flags = MDBX_RDONLY | MDBX_TXN_FINISHED;
+ txn->mt_owner = 0;
+ } else if (!F_ISSET(txn->mt_flags, MDBX_TXN_FINISHED)) {
+#if defined(MDBX_USE_VALGRIND) || defined(__SANITIZE_ADDRESS__)
+ if (txn == env->me_txn0)
+ mdbx_txn_valgrind(env, nullptr);
+#endif
+ /* Export or close DBI handles created in this txn */
+ mdbx_dbis_update(txn, mode & MDBX_END_UPDATE);
+ if (!(mode & MDBX_END_EOTDONE)) /* !(already closed cursors) */
+ mdbx_cursors_eot(txn, 0);
+ if (!(env->me_flags & MDBX_WRITEMAP))
+ mdbx_dlist_free(txn);
+
+ txn->mt_flags = MDBX_TXN_FINISHED;
+ txn->mt_owner = 0;
+ env->me_txn = txn->mt_parent;
+ if (txn == env->me_txn0) {
+ mdbx_assert(env, txn->mt_parent == NULL);
+ mdbx_pnl_shrink(&txn->tw.retired_pages);
+ mdbx_pnl_shrink(&txn->tw.reclaimed_pglist);
+ /* The writer mutex was locked in mdbx_txn_begin. */
+ mdbx_txn_unlock(env);
+ } else {
+ mdbx_assert(env, txn->mt_parent != NULL);
+ mdbx_assert(env, mdbx_pnl_check4assert(txn->tw.reclaimed_pglist,
+ txn->mt_next_pgno));
+ MDBX_txn *const parent = txn->mt_parent;
+ env->me_txn->mt_child = NULL;
+ env->me_txn->mt_flags &= ~MDBX_TXN_HAS_CHILD;
+ mdbx_pnl_free(txn->tw.reclaimed_pglist);
+ mdbx_pnl_free(txn->tw.spill_pages);
+
+ if (txn->tw.lifo_reclaimed) {
+ mdbx_assert(env, MDBX_PNL_SIZE(txn->tw.lifo_reclaimed) >=
+ (unsigned)(uintptr_t)parent->tw.lifo_reclaimed);
+ MDBX_PNL_SIZE(txn->tw.lifo_reclaimed) =
+ (unsigned)(uintptr_t)parent->tw.lifo_reclaimed;
+ parent->tw.lifo_reclaimed = txn->tw.lifo_reclaimed;
+ }
+
+ if (txn->tw.retired_pages) {
+ mdbx_assert(env, MDBX_PNL_SIZE(txn->tw.retired_pages) >=
+ (unsigned)(uintptr_t)parent->tw.retired_pages);
+ MDBX_PNL_SIZE(txn->tw.retired_pages) =
+ (unsigned)(uintptr_t)parent->tw.retired_pages;
+ parent->tw.retired_pages = txn->tw.retired_pages;
+ }
+
+ mdbx_free(txn->tw.dirtylist);
+
+ if (parent->mt_geo.upper != txn->mt_geo.upper ||
+ parent->mt_geo.now != txn->mt_geo.now) {
+ /* undo resize performed by child txn */
+ rc = mdbx_mapresize(env, parent->mt_geo.now, parent->mt_geo.upper);
+ if (rc == MDBX_RESULT_TRUE) {
+ /* unable undo resize (it is regular for Windows),
+ * therefore promote size changes from child to the parent txn */
+ mdbx_notice("unable undo resize performed by child txn, promote to "
+ "the parent (%u->%u, %u->%u)",
+ txn->mt_geo.now, parent->mt_geo.now, txn->mt_geo.upper,
+ parent->mt_geo.upper);
+ parent->mt_geo.now = txn->mt_geo.now;
+ parent->mt_geo.upper = txn->mt_geo.upper;
+ rc = MDBX_SUCCESS;
+ } else if (unlikely(rc != MDBX_SUCCESS)) {
+ mdbx_error("error %d while undo resize performed by child txn, fail "
+ "the parent",
+ rc);
+ parent->mt_flags |= MDBX_TXN_ERROR;
+ if (!env->me_dxb_mmap.address)
+ env->me_flags |= MDBX_FATAL_ERROR;
+ }
+ }
+ }
+ }
+
+ mdbx_assert(env, txn == env->me_txn0 || txn->mt_owner == 0);
+ if ((mode & MDBX_END_FREE) != 0 && txn != env->me_txn0) {
+ txn->mt_signature = 0;
+ mdbx_free(txn);
+ }
+
+ return rc;
+}
+
+int mdbx_txn_reset(MDBX_txn *txn) {
+ int rc = check_txn(txn, 0);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ /* This call is only valid for read-only txns */
+ if (unlikely((txn->mt_flags & MDBX_RDONLY) == 0))
+ return MDBX_EINVAL;
+
+ /* LY: don't close DBI-handles */
+ rc = mdbx_txn_end(txn, MDBX_END_RESET | MDBX_END_UPDATE);
+ if (rc == MDBX_SUCCESS) {
+ mdbx_tassert(txn, txn->mt_signature == MDBX_MT_SIGNATURE);
+ mdbx_tassert(txn, txn->mt_owner == 0);
+ }
+ return rc;
+}
+
+int mdbx_txn_abort(MDBX_txn *txn) {
+ int rc = check_txn(txn, 0);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ if (F_ISSET(txn->mt_flags, MDBX_RDONLY))
+ /* LY: don't close DBI-handles */
+ return mdbx_txn_end(txn, MDBX_END_ABORT | MDBX_END_UPDATE | MDBX_END_SLOT |
+ MDBX_END_FREE);
+
+ if (txn->mt_child)
+ mdbx_txn_abort(txn->mt_child);
+
+ return mdbx_txn_end(txn, MDBX_END_ABORT | MDBX_END_SLOT | MDBX_END_FREE);
+}
+
+static __inline int mdbx_backlog_size(MDBX_txn *txn) {
+ int reclaimed = MDBX_PNL_SIZE(txn->tw.reclaimed_pglist);
+ return reclaimed + txn->tw.loose_count;
+}
+
+static __inline int mdbx_backlog_extragap(MDBX_env *env) {
+ /* LY: extra page(s) for b-tree rebalancing */
+ return (env->me_flags & MDBX_LIFORECLAIM) ? 2 : 1;
+}
+
+/* LY: Prepare a backlog of pages to modify GC itself,
+ * while reclaiming is prohibited. It should be enough to prevent search
+ * in mdbx_page_alloc() during a deleting, when GC tree is unbalanced. */
+static int mdbx_prep_backlog(MDBX_txn *txn, MDBX_cursor *mc) {
+ /* LY: extra page(s) for b-tree rebalancing */
+ const int extra =
+ mdbx_backlog_extragap(txn->mt_env) +
+ MDBX_PNL_SIZEOF(txn->tw.retired_pages) / txn->mt_env->me_maxkey_limit;
+
+ if (mdbx_backlog_size(txn) < mc->mc_db->md_depth + extra) {
+ mc->mc_flags &= ~C_RECLAIMING;
+ int rc = mdbx_cursor_touch(mc);
+ if (unlikely(rc))
+ return rc;
+
+ while (unlikely(mdbx_backlog_size(txn) < extra)) {
+ rc = mdbx_page_alloc(mc, 1, NULL, MDBX_ALLOC_GC);
+ if (unlikely(rc)) {
+ if (rc != MDBX_NOTFOUND)
+ return rc;
+ break;
+ }
+ }
+ mc->mc_flags |= C_RECLAIMING;
+ }
+
+ return MDBX_SUCCESS;
+}
+
+static void mdbx_prep_backlog_data(MDBX_txn *txn, MDBX_cursor *mc,
+ size_t bytes) {
+ const int wanna = (int)number_of_ovpages(txn->mt_env, bytes) +
+ mdbx_backlog_extragap(txn->mt_env);
+ if (unlikely(wanna > mdbx_backlog_size(txn))) {
+ mc->mc_flags &= ~C_RECLAIMING;
+ do {
+ if (mdbx_page_alloc(mc, 1, NULL, MDBX_ALLOC_GC) != MDBX_SUCCESS)
+ break;
+ } while (wanna > mdbx_backlog_size(txn));
+ mc->mc_flags |= C_RECLAIMING;
+ }
+}
+
+/* Count all the pages in each DB and in the freelist and make sure
+ * it matches the actual number of pages being used.
+ * All named DBs must be open for a correct count. */
+static __cold int mdbx_audit_ex(MDBX_txn *txn, unsigned retired_stored,
+ bool dont_filter_gc) {
+ pgno_t pending = 0;
+ if ((txn->mt_flags & MDBX_RDONLY) == 0) {
+ pending = txn->tw.loose_count + MDBX_PNL_SIZE(txn->tw.reclaimed_pglist) +
+ (MDBX_PNL_SIZE(txn->tw.retired_pages) - retired_stored) +
+ txn->tw.retired2parent_count;
+ for (MDBX_txn *parent = txn->mt_parent; parent; parent = parent->mt_parent)
+ pending += parent->tw.loose_count;
+ }
+
+ MDBX_cursor_couple cx;
+ int rc = mdbx_cursor_init(&cx.outer, txn, FREE_DBI);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ pgno_t freecount = 0;
+ MDBX_val key, data;
+ while ((rc = mdbx_cursor_get(&cx.outer, &key, &data, MDBX_NEXT)) == 0) {
+ if (!dont_filter_gc) {
+ if (unlikely(key.iov_len != sizeof(txnid_t)))
+ return MDBX_CORRUPTED;
+ txnid_t id = unaligned_peek_u64(4, key.iov_base);
+ if (txn->tw.lifo_reclaimed) {
+ for (unsigned i = 1; i <= MDBX_PNL_SIZE(txn->tw.lifo_reclaimed); ++i)
+ if (id == txn->tw.lifo_reclaimed[i])
+ goto skip;
+ } else if (id <= txn->tw.last_reclaimed)
+ goto skip;
+ }
+
+ freecount += *(pgno_t *)data.iov_base;
+ skip:;
+ }
+ mdbx_tassert(txn, rc == MDBX_NOTFOUND);
+
+ for (MDBX_dbi i = FREE_DBI; i < txn->mt_numdbs; i++)
+ txn->mt_dbflags[i] &= ~DB_AUDITED;
+
+ pgno_t count = 0;
+ for (MDBX_dbi i = FREE_DBI; i <= MAIN_DBI; i++) {
+ if (!(txn->mt_dbflags[i] & DB_VALID))
+ continue;
+ rc = mdbx_cursor_init(&cx.outer, txn, i);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+ txn->mt_dbflags[i] |= DB_AUDITED;
+ if (txn->mt_dbs[i].md_root == P_INVALID)
+ continue;
+ count += txn->mt_dbs[i].md_branch_pages + txn->mt_dbs[i].md_leaf_pages +
+ txn->mt_dbs[i].md_overflow_pages;
+
+ if (i != MAIN_DBI)
+ continue;
+ rc = mdbx_page_search(&cx.outer, NULL, MDBX_PS_FIRST);
+ while (rc == MDBX_SUCCESS) {
+ MDBX_page *mp = cx.outer.mc_pg[cx.outer.mc_top];
+ for (unsigned j = 0; j < page_numkeys(mp); j++) {
+ MDBX_node *node = page_node(mp, j);
+ if (node_flags(node) == F_SUBDATA) {
+ if (unlikely(node_ds(node) < sizeof(MDBX_db)))
+ return MDBX_CORRUPTED;
+ MDBX_db db_copy, *db;
+ memcpy(db = &db_copy, node_data(node), sizeof(db_copy));
+ if ((txn->mt_flags & MDBX_RDONLY) == 0) {
+ for (MDBX_dbi k = txn->mt_numdbs; --k > MAIN_DBI;) {
+ if ((txn->mt_dbflags[k] & DB_VALID) &&
+ /* txn->mt_dbxs[k].md_name.iov_len > 0 && */
+ node_ks(node) == txn->mt_dbxs[k].md_name.iov_len &&
+ memcmp(node_key(node), txn->mt_dbxs[k].md_name.iov_base,
+ node_ks(node)) == 0) {
+ txn->mt_dbflags[k] |= DB_AUDITED;
+ if (txn->mt_dbflags[k] & DB_DIRTY) {
+ mdbx_tassert(txn, (txn->mt_dbflags[k] & DB_STALE) == 0);
+ db = txn->mt_dbs + k;
+ }
+ break;
+ }
+ }
+ }
+ count +=
+ db->md_branch_pages + db->md_leaf_pages + db->md_overflow_pages;
+ }
+ }
+ rc = mdbx_cursor_sibling(&cx.outer, 1);
+ }
+ mdbx_tassert(txn, rc == MDBX_NOTFOUND);
+ }
+
+ for (MDBX_dbi i = FREE_DBI; i < txn->mt_numdbs; i++) {
+ if ((txn->mt_dbflags[i] & (DB_VALID | DB_AUDITED | DB_STALE)) != DB_VALID)
+ continue;
+ if (F_ISSET(txn->mt_dbflags[i], DB_DIRTY | DB_CREAT)) {
+ count += txn->mt_dbs[i].md_branch_pages + txn->mt_dbs[i].md_leaf_pages +
+ txn->mt_dbs[i].md_overflow_pages;
+ } else {
+ mdbx_warning("audit %s@%" PRIaTXN
+ ": unable account dbi %d / \"%*s\", state 0x%02x",
+ txn->mt_parent ? "nested-" : "", txn->mt_txnid, i,
+ (int)txn->mt_dbxs[i].md_name.iov_len,
+ (const char *)txn->mt_dbxs[i].md_name.iov_base,
+ txn->mt_dbflags[i]);
+ }
+ }
+
+ if (pending + freecount + count + NUM_METAS == txn->mt_next_pgno)
+ return MDBX_SUCCESS;
+
+ if ((txn->mt_flags & MDBX_RDONLY) == 0)
+ mdbx_error("audit @%" PRIaTXN ": %u(pending) = %u(loose-count) + "
+ "%u(reclaimed-list) + %u(retired-pending) - %u(retired-stored) "
+ "+ %u(retired2parent)",
+ txn->mt_txnid, pending, txn->tw.loose_count,
+ MDBX_PNL_SIZE(txn->tw.reclaimed_pglist),
+ txn->tw.retired_pages ? MDBX_PNL_SIZE(txn->tw.retired_pages) : 0,
+ retired_stored, txn->tw.retired2parent_count);
+ mdbx_error("audit @%" PRIaTXN ": %" PRIaPGNO "(pending) + %" PRIaPGNO
+ "(free) + %" PRIaPGNO "(count) = %" PRIaPGNO
+ "(total) <> %" PRIaPGNO "(next-pgno)",
+ txn->mt_txnid, pending, freecount, count + NUM_METAS,
+ pending + freecount + count + NUM_METAS, txn->mt_next_pgno);
+ return MDBX_PROBLEM;
+}
+
+static __inline void clean_reserved_gc_pnl(MDBX_env *env, MDBX_val pnl) {
+ /* PNL is initially empty, zero out at least the length */
+ memset(pnl.iov_base, 0, sizeof(pgno_t));
+ if ((env->me_flags & (MDBX_WRITEMAP | MDBX_NOMEMINIT)) == 0)
+ /* zero out to avoid leaking values from uninitialized malloc'ed memory
+ * to the file in non-writemap mode if length of the saving page-list
+ * was changed during space reservation. */
+ memset(pnl.iov_base, 0, pnl.iov_len);
+}
+
+/* Cleanup reclaimed GC records, than save the retired-list as of this
+ * transaction to GC (aka freeDB). This recursive changes the reclaimed-list
+ * loose-list and retired-list. Keep trying until it stabilizes. */
+static int mdbx_update_gc(MDBX_txn *txn) {
+ /* txn->tw.reclaimed_pglist[] can grow and shrink during this call.
+ * txn->tw.last_reclaimed and txn->tw.retired_pages[] can only grow.
+ * Page numbers cannot disappear from txn->tw.retired_pages[]. */
+ MDBX_env *const env = txn->mt_env;
+ const bool lifo = (env->me_flags & MDBX_LIFORECLAIM) != 0;
+ const char *dbg_prefix_mode = lifo ? " lifo" : " fifo";
+ (void)dbg_prefix_mode;
+ mdbx_trace("\n>>> @%" PRIaTXN, txn->mt_txnid);
+
+ unsigned retired_stored = 0, loop = 0;
+ MDBX_cursor mc;
+ int rc = mdbx_cursor_init(&mc, txn, FREE_DBI);
+ if (unlikely(rc != MDBX_SUCCESS))
+ goto bailout_notracking;
+
+ mc.mc_flags |= C_RECLAIMING;
+ mc.mc_next = txn->mt_cursors[FREE_DBI];
+ txn->mt_cursors[FREE_DBI] = &mc;
+
+retry:
+ mdbx_trace("%s", " >> restart");
+ mdbx_tassert(
+ txn, mdbx_pnl_check4assert(txn->tw.reclaimed_pglist, txn->mt_next_pgno));
+ mdbx_tassert(txn, mdbx_dirtylist_check(txn));
+ mdbx_tassert(txn, txn->tw.dirtyroom + txn->tw.dirtylist->length ==
+ MDBX_DPL_TXNFULL);
+ if (unlikely(/* paranoia */ ++loop > 42)) {
+ mdbx_error("too more loops %u, bailout", loop);
+ rc = MDBX_PROBLEM;
+ goto bailout;
+ }
+
+ unsigned settled = 0, cleaned_gc_slot = 0, reused_gc_slot = 0,
+ filled_gc_slot = ~0u;
+ txnid_t cleaned_gc_id = 0, gc_rid = txn->tw.last_reclaimed;
+ while (true) {
+ /* Come back here after each Put() in case retired-list changed */
+ MDBX_val key, data;
+ mdbx_trace("%s", " >> continue");
+
+ mdbx_tassert(txn, mdbx_pnl_check4assert(txn->tw.reclaimed_pglist,
+ txn->mt_next_pgno));
+ if (txn->tw.lifo_reclaimed) {
+ if (cleaned_gc_slot < MDBX_PNL_SIZE(txn->tw.lifo_reclaimed)) {
+ settled = 0;
+ cleaned_gc_slot = 0;
+ reused_gc_slot = 0;
+ filled_gc_slot = ~0u;
+ /* LY: cleanup reclaimed records. */
+ do {
+ cleaned_gc_id = txn->tw.lifo_reclaimed[++cleaned_gc_slot];
+ mdbx_tassert(txn,
+ cleaned_gc_slot > 0 && cleaned_gc_id < *env->me_oldest);
+ key.iov_base = &cleaned_gc_id;
+ key.iov_len = sizeof(cleaned_gc_id);
+ rc = mdbx_cursor_get(&mc, &key, NULL, MDBX_SET);
+ if (rc == MDBX_NOTFOUND)
+ continue;
+ if (unlikely(rc != MDBX_SUCCESS))
+ goto bailout;
+ rc = mdbx_prep_backlog(txn, &mc);
+ if (unlikely(rc != MDBX_SUCCESS))
+ goto bailout;
+ mdbx_tassert(txn, cleaned_gc_id < *env->me_oldest);
+ mdbx_trace("%s.cleanup-reclaimed-id [%u]%" PRIaTXN, dbg_prefix_mode,
+ cleaned_gc_slot, cleaned_gc_id);
+ rc = mdbx_cursor_del(&mc, 0);
+ if (unlikely(rc != MDBX_SUCCESS))
+ goto bailout;
+ } while (cleaned_gc_slot < MDBX_PNL_SIZE(txn->tw.lifo_reclaimed));
+ mdbx_txl_sort(txn->tw.lifo_reclaimed);
+ gc_rid = MDBX_PNL_LAST(txn->tw.lifo_reclaimed);
+ }
+ } else {
+ /* If using records from GC which we have not yet deleted,
+ * now delete them and any we reserved for me_reclaimed_pglist. */
+ while (cleaned_gc_id <= txn->tw.last_reclaimed) {
+ gc_rid = cleaned_gc_id;
+ settled = 0;
+ rc = mdbx_cursor_first(&mc, &key, NULL);
+ if (unlikely(rc != MDBX_SUCCESS)) {
+ if (rc == MDBX_NOTFOUND)
+ break;
+ goto bailout;
+ }
+ if (unlikely(key.iov_len != sizeof(txnid_t))) {
+ rc = MDBX_CORRUPTED;
+ goto bailout;
+ }
+ cleaned_gc_id = unaligned_peek_u64(4, key.iov_base);
+ if (unlikely(cleaned_gc_id < 1 ||
+ cleaned_gc_id >= SAFE64_INVALID_THRESHOLD)) {
+ rc = MDBX_CORRUPTED;
+ goto bailout;
+ }
+ if (cleaned_gc_id > txn->tw.last_reclaimed)
+ break;
+ if (cleaned_gc_id < txn->tw.last_reclaimed) {
+ rc = mdbx_prep_backlog(txn, &mc);
+ if (unlikely(rc != MDBX_SUCCESS))
+ goto bailout;
+ }
+ mdbx_tassert(txn, cleaned_gc_id <= txn->tw.last_reclaimed);
+ mdbx_tassert(txn, cleaned_gc_id < *env->me_oldest);
+ mdbx_trace("%s.cleanup-reclaimed-id %" PRIaTXN, dbg_prefix_mode,
+ cleaned_gc_id);
+ rc = mdbx_cursor_del(&mc, 0);
+ if (unlikely(rc != MDBX_SUCCESS))
+ goto bailout;
+ }
+ }
+
+ mdbx_tassert(txn, mdbx_pnl_check4assert(txn->tw.reclaimed_pglist,
+ txn->mt_next_pgno));
+ mdbx_tassert(txn, mdbx_dirtylist_check(txn));
+ mdbx_tassert(txn, txn->tw.dirtyroom + txn->tw.dirtylist->length ==
+ MDBX_DPL_TXNFULL);
+ if (mdbx_audit_enabled()) {
+ rc = mdbx_audit_ex(txn, retired_stored, false);
+ if (unlikely(rc != MDBX_SUCCESS))
+ goto bailout;
+ }
+
+ /* return suitable into unallocated space */
+ if (mdbx_refund(txn)) {
+ mdbx_tassert(txn, mdbx_pnl_check4assert(txn->tw.reclaimed_pglist,
+ txn->mt_next_pgno));
+ if (mdbx_audit_enabled()) {
+ rc = mdbx_audit_ex(txn, retired_stored, false);
+ if (unlikely(rc != MDBX_SUCCESS))
+ goto bailout;
+ }
+ }
+
+ /* handle loose pages - put ones into the reclaimed- or retired-list */
+ if (txn->tw.loose_pages) {
+ /* Return loose page numbers to me_reclaimed_pglist,
+ * though usually none are left at this point.
+ * The pages themselves remain in dirtylist. */
+ if (unlikely(!txn->tw.lifo_reclaimed && txn->tw.last_reclaimed < 1)) {
+ if (txn->tw.loose_count > 0) {
+ /* Put loose page numbers in tw.retired_pages,
+ * since unable to return them to me_reclaimed_pglist. */
+ if (unlikely((rc = mdbx_pnl_need(&txn->tw.retired_pages,
+ txn->tw.loose_count)) != 0))
+ goto bailout;
+ for (MDBX_page *mp = txn->tw.loose_pages; mp; mp = mp->mp_next)
+ mdbx_pnl_xappend(txn->tw.retired_pages, mp->mp_pgno);
+ mdbx_trace("%s: append %u loose-pages to retired-pages",
+ dbg_prefix_mode, txn->tw.loose_count);
+ }
+ } else {
+ /* Room for loose pages + temp PNL with same */
+ rc = mdbx_pnl_need(&txn->tw.reclaimed_pglist,
+ 2 * txn->tw.loose_count + 2);
+ if (unlikely(rc != MDBX_SUCCESS))
+ goto bailout;
+ MDBX_PNL loose = txn->tw.reclaimed_pglist +
+ MDBX_PNL_ALLOCLEN(txn->tw.reclaimed_pglist) -
+ txn->tw.loose_count - 1;
+ unsigned count = 0;
+ for (MDBX_page *mp = txn->tw.loose_pages; mp; mp = mp->mp_next) {
+ mdbx_tassert(txn, mp->mp_flags == (P_LOOSE | P_DIRTY));
+ loose[++count] = mp->mp_pgno;
+ }
+ mdbx_tassert(txn, count == txn->tw.loose_count);
+ MDBX_PNL_SIZE(loose) = count;
+ mdbx_pnl_sort(loose);
+ mdbx_pnl_xmerge(txn->tw.reclaimed_pglist, loose);
+ mdbx_trace("%s: append %u loose-pages to reclaimed-pages",
+ dbg_prefix_mode, txn->tw.loose_count);
+ }
+
+ /* filter-out list of dirty-pages from loose-pages */
+ const MDBX_DPL dl = txn->tw.dirtylist;
+ unsigned w = 0;
+ for (unsigned r = w; ++r <= dl->length;) {
+ MDBX_page *dp = dl[r].ptr;
+ mdbx_tassert(txn, (dp->mp_flags & P_DIRTY));
+ mdbx_tassert(txn, dl[r].pgno + (IS_OVERFLOW(dp) ? dp->mp_pages : 1) <=
+ txn->mt_next_pgno);
+ if ((dp->mp_flags & P_LOOSE) == 0) {
+ if (++w != r)
+ dl[w] = dl[r];
+ } else {
+ mdbx_tassert(txn, dp->mp_flags == (P_LOOSE | P_DIRTY));
+ if ((env->me_flags & MDBX_WRITEMAP) == 0)
+ mdbx_dpage_free(env, dp, 1);
+ }
+ }
+ mdbx_trace("%s: filtered-out loose-pages from %u -> %u dirty-pages",
+ dbg_prefix_mode, dl->length, w);
+ mdbx_tassert(txn, txn->tw.loose_count == dl->length - w);
+ dl->length = w;
+ dl->sorted = 0;
+ txn->tw.dirtyroom += txn->tw.loose_count;
+ txn->tw.loose_pages = NULL;
+ txn->tw.loose_count = 0;
+ }
+
+ /* handle retired-list - store ones into single gc-record */
+ if (retired_stored < MDBX_PNL_SIZE(txn->tw.retired_pages)) {
+ if (unlikely(!retired_stored)) {
+ /* Make sure last page of GC is touched and on retired-list */
+ mc.mc_flags &= ~C_RECLAIMING;
+ rc = mdbx_page_search(&mc, NULL, MDBX_PS_LAST | MDBX_PS_MODIFY);
+ mc.mc_flags |= C_RECLAIMING;
+ if (unlikely(rc != MDBX_SUCCESS) && rc != MDBX_NOTFOUND)
+ goto bailout;
+ }
+ /* Write to last page of GC */
+ key.iov_len = sizeof(txn->mt_txnid);
+ key.iov_base = &txn->mt_txnid;
+ do {
+ data.iov_len = MDBX_PNL_SIZEOF(txn->tw.retired_pages);
+ mdbx_prep_backlog_data(txn, &mc, data.iov_len);
+ rc = mdbx_cursor_put(&mc, &key, &data, MDBX_RESERVE);
+ if (unlikely(rc != MDBX_SUCCESS))
+ goto bailout;
+ /* Retry if tw.retired_pages[] grew during the Put() */
+ } while (data.iov_len < MDBX_PNL_SIZEOF(txn->tw.retired_pages));
+
+ retired_stored = (unsigned)MDBX_PNL_SIZE(txn->tw.retired_pages);
+ mdbx_pnl_sort(txn->tw.retired_pages);
+ mdbx_assert(env, data.iov_len == MDBX_PNL_SIZEOF(txn->tw.retired_pages));
+ memcpy(data.iov_base, txn->tw.retired_pages, data.iov_len);
+
+ mdbx_trace("%s.put-retired #%u @ %" PRIaTXN, dbg_prefix_mode,
+ retired_stored, txn->mt_txnid);
+
+ if (mdbx_log_enabled(MDBX_LOG_EXTRA)) {
+ unsigned i = retired_stored;
+ mdbx_debug_extra("PNL write txn %" PRIaTXN " root %" PRIaPGNO
+ " num %u, PNL",
+ txn->mt_txnid, txn->mt_dbs[FREE_DBI].md_root, i);
+ for (; i; i--)
+ mdbx_debug_extra_print(" %" PRIaPGNO, txn->tw.retired_pages[i]);
+ mdbx_debug_extra_print("%s", "\n");
+ }
+ continue;
+ }
+
+ /* handle reclaimed and loost pages - merge and store both into gc */
+ mdbx_tassert(txn, mdbx_pnl_check4assert(txn->tw.reclaimed_pglist,
+ txn->mt_next_pgno));
+ mdbx_tassert(txn, txn->tw.loose_count == 0);
+
+ mdbx_trace("%s", " >> reserving");
+ if (mdbx_audit_enabled()) {
+ rc = mdbx_audit_ex(txn, retired_stored, false);
+ if (unlikely(rc != MDBX_SUCCESS))
+ goto bailout;
+ }
+ const unsigned amount = (unsigned)MDBX_PNL_SIZE(txn->tw.reclaimed_pglist);
+ const unsigned left = amount - settled;
+ mdbx_trace("%s: amount %u, settled %d, left %d, lifo-reclaimed-slots %u, "
+ "reused-gc-slots %u",
+ dbg_prefix_mode, amount, settled, (int)left,
+ txn->tw.lifo_reclaimed
+ ? (unsigned)MDBX_PNL_SIZE(txn->tw.lifo_reclaimed)
+ : 0,
+ reused_gc_slot);
+ if (0 >= (int)left)
+ break;
+
+ const unsigned prefer_max_scatter = 257;
+ txnid_t reservation_gc_id;
+ if (lifo) {
+ const unsigned lifo_len =
+ txn->tw.lifo_reclaimed
+ ? (unsigned)MDBX_PNL_SIZE(txn->tw.lifo_reclaimed)
+ : 0;
+ if (lifo_len < prefer_max_scatter &&
+ left > (lifo_len - reused_gc_slot) * env->me_maxgc_ov1page) {
+ /* LY: need just a txn-id for save page list. */
+ mc.mc_flags &= ~C_RECLAIMING;
+ rc = mdbx_page_alloc(&mc, 0, NULL, MDBX_ALLOC_GC | MDBX_ALLOC_KICK);
+ mc.mc_flags |= C_RECLAIMING;
+ if (likely(rc == MDBX_SUCCESS)) {
+ /* LY: ok, reclaimed from GC. */
+ mdbx_trace("%s: took @%" PRIaTXN " from GC, continue",
+ dbg_prefix_mode, MDBX_PNL_LAST(txn->tw.lifo_reclaimed));
+ continue;
+ }
+ if (unlikely(rc != MDBX_NOTFOUND))
+ /* LY: other troubles... */
+ goto bailout;
+
+ /* LY: GC is empty, will look any free txn-id in high2low order. */
+ if (unlikely(gc_rid == 0)) {
+ mdbx_tassert(txn, txn->tw.last_reclaimed == 0);
+ txn->tw.last_reclaimed = gc_rid = mdbx_find_oldest(txn) - 1;
+ if (txn->tw.lifo_reclaimed == nullptr) {
+ txn->tw.lifo_reclaimed = mdbx_txl_alloc();
+ if (unlikely(!txn->tw.lifo_reclaimed)) {
+ rc = MDBX_ENOMEM;
+ goto bailout;
+ }
+ }
+ }
+
+ mdbx_tassert(txn, txn->tw.lifo_reclaimed != nullptr);
+ rc = MDBX_RESULT_TRUE;
+ do {
+ if (unlikely(gc_rid <= 1)) {
+ if (unlikely(MDBX_PNL_SIZE(txn->tw.lifo_reclaimed) <=
+ reused_gc_slot)) {
+ mdbx_notice("** restart: reserve depleted (reused_gc_slot %u >= "
+ "lifo_reclaimed %u" PRIaTXN,
+ reused_gc_slot,
+ (unsigned)MDBX_PNL_SIZE(txn->tw.lifo_reclaimed));
+ goto retry;
+ }
+ break;
+ }
+
+ mdbx_tassert(txn, gc_rid > 1 && gc_rid < SAFE64_INVALID_THRESHOLD);
+ rc = mdbx_txl_append(&txn->tw.lifo_reclaimed, --gc_rid);
+ if (unlikely(rc != MDBX_SUCCESS))
+ goto bailout;
+ cleaned_gc_slot += 1 /* mark GC cleanup is not needed. */;
+
+ mdbx_trace("%s: append @%" PRIaTXN
+ " to lifo-reclaimed, cleaned-gc-slot = %u",
+ dbg_prefix_mode, gc_rid, cleaned_gc_slot);
+ } while (gc_rid &&
+ MDBX_PNL_SIZE(txn->tw.lifo_reclaimed) < prefer_max_scatter &&
+ left > ((unsigned)MDBX_PNL_SIZE(txn->tw.lifo_reclaimed) -
+ reused_gc_slot) *
+ env->me_maxgc_ov1page);
+ if (reused_gc_slot && rc != MDBX_RESULT_TRUE) {
+ mdbx_trace("%s: restart innter-loop since reused_gc_slot %u > 0",
+ dbg_prefix_mode, reused_gc_slot);
+ continue;
+ }
+ }
+
+ const unsigned i =
+ (unsigned)MDBX_PNL_SIZE(txn->tw.lifo_reclaimed) - reused_gc_slot;
+ mdbx_tassert(txn, i > 0 && i <= MDBX_PNL_SIZE(txn->tw.lifo_reclaimed));
+ reservation_gc_id = txn->tw.lifo_reclaimed[i];
+ mdbx_trace("%s: take @%" PRIaTXN " from lifo-reclaimed[%u]",
+ dbg_prefix_mode, reservation_gc_id, i);
+ } else {
+ mdbx_tassert(txn, txn->tw.lifo_reclaimed == NULL);
+ if (unlikely(gc_rid == 0)) {
+ gc_rid = mdbx_find_oldest(txn) - 1;
+ rc = mdbx_cursor_get(&mc, &key, NULL, MDBX_FIRST);
+ if (rc == MDBX_SUCCESS) {
+ if (unlikely(key.iov_len != sizeof(txnid_t))) {
+ rc = MDBX_CORRUPTED;
+ goto bailout;
+ }
+ txnid_t gc_first = unaligned_peek_u64(4, key.iov_base);
+ if (unlikely(gc_first < 1 || gc_first >= SAFE64_INVALID_THRESHOLD)) {
+ rc = MDBX_CORRUPTED;
+ goto bailout;
+ }
+ if (gc_rid >= gc_first)
+ gc_rid = gc_first - 1;
+ if (unlikely(gc_rid == 0)) {
+ mdbx_error("%s", "** no GC tail-space to store");
+ rc = MDBX_PROBLEM;
+ goto bailout;
+ }
+ } else if (rc != MDBX_NOTFOUND)
+ goto bailout;
+ mdbx_tassert(txn, txn->tw.last_reclaimed == 0);
+ txn->tw.last_reclaimed = gc_rid;
+ }
+ reservation_gc_id = gc_rid--;
+ mdbx_trace("%s: take @%" PRIaTXN " from head-gc-id", dbg_prefix_mode,
+ reservation_gc_id);
+ }
+ ++reused_gc_slot;
+
+ unsigned chunk = left;
+ if (unlikely(chunk > env->me_maxgc_ov1page)) {
+ const unsigned avail_gc_slots =
+ txn->tw.lifo_reclaimed
+ ? (unsigned)MDBX_PNL_SIZE(txn->tw.lifo_reclaimed) -
+ reused_gc_slot + 1
+ : (gc_rid < INT16_MAX) ? (unsigned)gc_rid : INT16_MAX;
+ if (avail_gc_slots > 1) {
+ if (chunk < env->me_maxgc_ov1page * 2)
+ chunk /= 2;
+ else {
+ const unsigned threshold =
+ env->me_maxgc_ov1page * ((avail_gc_slots < prefer_max_scatter)
+ ? avail_gc_slots
+ : prefer_max_scatter);
+ if (left < threshold)
+ chunk = env->me_maxgc_ov1page;
+ else {
+ const unsigned tail = left - threshold + env->me_maxgc_ov1page + 1;
+ unsigned span = 1;
+ unsigned avail = (unsigned)((pgno2bytes(env, span) - PAGEHDRSZ) /
+ sizeof(pgno_t)) /*- 1 + span */;
+ if (tail > avail) {
+ for (unsigned i = amount - span; i > 0; --i) {
+ if (MDBX_PNL_ASCENDING
+ ? (txn->tw.reclaimed_pglist[i] + span)
+ : (txn->tw.reclaimed_pglist[i] - span) ==
+ txn->tw.reclaimed_pglist[i + span]) {
+ span += 1;
+ avail = (unsigned)((pgno2bytes(env, span) - PAGEHDRSZ) /
+ sizeof(pgno_t)) -
+ 1 + span;
+ if (avail >= tail)
+ break;
+ }
+ }
+ }
+
+ chunk = (avail >= tail) ? tail - span
+ : (avail_gc_slots > 3 &&
+ reused_gc_slot < prefer_max_scatter - 3)
+ ? avail - span
+ : tail;
+ }
+ }
+ }
+ }
+ mdbx_tassert(txn, chunk > 0);
+
+ mdbx_trace("%s: rc_rid %" PRIaTXN ", reused_gc_slot %u, reservation-id "
+ "%" PRIaTXN,
+ dbg_prefix_mode, gc_rid, reused_gc_slot, reservation_gc_id);
+
+ mdbx_trace("%s: chunk %u, gc-per-ovpage %u", dbg_prefix_mode, chunk,
+ env->me_maxgc_ov1page);
+
+ mdbx_tassert(txn, reservation_gc_id < *env->me_oldest);
+ if (unlikely(reservation_gc_id < 1 ||
+ reservation_gc_id >= *env->me_oldest)) {
+ mdbx_error("%s", "** internal error (reservation_gc_id)");
+ rc = MDBX_PROBLEM;
+ goto bailout;
+ }
+
+ key.iov_len = sizeof(reservation_gc_id);
+ key.iov_base = &reservation_gc_id;
+ data.iov_len = (chunk + 1) * sizeof(pgno_t);
+ mdbx_trace("%s.reserve: %u [%u...%u] @%" PRIaTXN, dbg_prefix_mode, chunk,
+ settled + 1, settled + chunk + 1, reservation_gc_id);
+ mdbx_prep_backlog_data(txn, &mc, data.iov_len);
+ rc = mdbx_cursor_put(&mc, &key, &data, MDBX_RESERVE | MDBX_NOOVERWRITE);
+ mdbx_tassert(txn, mdbx_pnl_check4assert(txn->tw.reclaimed_pglist,
+ txn->mt_next_pgno));
+ if (unlikely(rc != MDBX_SUCCESS))
+ goto bailout;
+
+ clean_reserved_gc_pnl(env, data);
+ settled += chunk;
+ mdbx_trace("%s.settled %u (+%u), continue", dbg_prefix_mode, settled,
+ chunk);
+
+ if (txn->tw.lifo_reclaimed &&
+ unlikely(amount < MDBX_PNL_SIZE(txn->tw.reclaimed_pglist))) {
+ mdbx_notice("** restart: reclaimed-list growth %u -> %u", amount,
+ (unsigned)MDBX_PNL_SIZE(txn->tw.reclaimed_pglist));
+ goto retry;
+ }
+
+ continue;
+ }
+
+ mdbx_tassert(
+ txn,
+ cleaned_gc_slot ==
+ (txn->tw.lifo_reclaimed ? MDBX_PNL_SIZE(txn->tw.lifo_reclaimed) : 0));
+
+ mdbx_trace("%s", " >> filling");
+ /* Fill in the reserved records */
+ filled_gc_slot =
+ txn->tw.lifo_reclaimed
+ ? (unsigned)MDBX_PNL_SIZE(txn->tw.lifo_reclaimed) - reused_gc_slot
+ : reused_gc_slot;
+ rc = MDBX_SUCCESS;
+ mdbx_tassert(
+ txn, mdbx_pnl_check4assert(txn->tw.reclaimed_pglist, txn->mt_next_pgno));
+ mdbx_tassert(txn, mdbx_dirtylist_check(txn));
+ if (MDBX_PNL_SIZE(txn->tw.reclaimed_pglist)) {
+ MDBX_val key, data;
+ key.iov_len = data.iov_len = 0; /* avoid MSVC warning */
+ key.iov_base = data.iov_base = NULL;
+
+ const unsigned amount = MDBX_PNL_SIZE(txn->tw.reclaimed_pglist);
+ unsigned left = amount;
+ if (txn->tw.lifo_reclaimed == nullptr) {
+ mdbx_tassert(txn, lifo == 0);
+ rc = mdbx_cursor_first(&mc, &key, &data);
+ if (unlikely(rc != MDBX_SUCCESS))
+ goto bailout;
+ } else {
+ mdbx_tassert(txn, lifo != 0);
+ }
+
+ while (true) {
+ txnid_t fill_gc_id;
+ mdbx_trace("%s: left %u of %u", dbg_prefix_mode, left,
+ (unsigned)MDBX_PNL_SIZE(txn->tw.reclaimed_pglist));
+ if (txn->tw.lifo_reclaimed == nullptr) {
+ mdbx_tassert(txn, lifo == 0);
+ fill_gc_id = unaligned_peek_u64(4, key.iov_base);
+ if (filled_gc_slot-- == 0 || fill_gc_id > txn->tw.last_reclaimed) {
+ mdbx_notice(
+ "** restart: reserve depleted (filled_slot %u, fill_id %" PRIaTXN
+ " > last_reclaimed %" PRIaTXN,
+ filled_gc_slot, fill_gc_id, txn->tw.last_reclaimed);
+ goto retry;
+ }
+ } else {
+ mdbx_tassert(txn, lifo != 0);
+ if (++filled_gc_slot >
+ (unsigned)MDBX_PNL_SIZE(txn->tw.lifo_reclaimed)) {
+ mdbx_notice("** restart: reserve depleted (filled_gc_slot %u > "
+ "lifo_reclaimed %u" PRIaTXN,
+ filled_gc_slot,
+ (unsigned)MDBX_PNL_SIZE(txn->tw.lifo_reclaimed));
+ goto retry;
+ }
+ fill_gc_id = txn->tw.lifo_reclaimed[filled_gc_slot];
+ mdbx_trace("%s.seek-reservation @%" PRIaTXN " at lifo_reclaimed[%u]",
+ dbg_prefix_mode, fill_gc_id, filled_gc_slot);
+ key.iov_base = &fill_gc_id;
+ key.iov_len = sizeof(fill_gc_id);
+ rc = mdbx_cursor_get(&mc, &key, &data, MDBX_SET_KEY);
+ if (unlikely(rc != MDBX_SUCCESS))
+ goto bailout;
+ }
+ mdbx_tassert(txn, cleaned_gc_slot ==
+ (txn->tw.lifo_reclaimed
+ ? MDBX_PNL_SIZE(txn->tw.lifo_reclaimed)
+ : 0));
+ mdbx_tassert(txn, fill_gc_id > 0 && fill_gc_id < *env->me_oldest);
+ key.iov_base = &fill_gc_id;
+ key.iov_len = sizeof(fill_gc_id);
+
+ mdbx_tassert(txn, data.iov_len >= sizeof(pgno_t) * 2);
+ mc.mc_flags |= C_GCFREEZE;
+ unsigned chunk = (unsigned)(data.iov_len / sizeof(pgno_t)) - 1;
+ if (unlikely(chunk > left)) {
+ mdbx_trace("%s: chunk %u > left %u, @%" PRIaTXN, dbg_prefix_mode, chunk,
+ left, fill_gc_id);
+ if ((loop < 5 && chunk - left > loop / 2) ||
+ chunk - left > env->me_maxgc_ov1page) {
+ data.iov_len = (left + 1) * sizeof(pgno_t);
+ if (loop < 7)
+ mc.mc_flags &= ~C_GCFREEZE;
+ }
+ chunk = left;
+ }
+ rc = mdbx_cursor_put(&mc, &key, &data, MDBX_CURRENT | MDBX_RESERVE);
+ mc.mc_flags &= ~C_GCFREEZE;
+ if (unlikely(rc != MDBX_SUCCESS))
+ goto bailout;
+ clean_reserved_gc_pnl(env, data);
+
+ if (unlikely(txn->tw.loose_count ||
+ amount != MDBX_PNL_SIZE(txn->tw.reclaimed_pglist))) {
+ mdbx_notice("** restart: reclaimed-list changed (%u -> %u, %u)", amount,
+ MDBX_PNL_SIZE(txn->tw.reclaimed_pglist),
+ txn->tw.loose_count);
+ goto retry;
+ }
+ if (unlikely(txn->tw.lifo_reclaimed
+ ? cleaned_gc_slot < MDBX_PNL_SIZE(txn->tw.lifo_reclaimed)
+ : cleaned_gc_id < txn->tw.last_reclaimed)) {
+ mdbx_notice("%s", "** restart: reclaimed-slots changed");
+ goto retry;
+ }
+
+ pgno_t *dst = data.iov_base;
+ *dst++ = chunk;
+ pgno_t *src = MDBX_PNL_BEGIN(txn->tw.reclaimed_pglist) + left - chunk;
+ memcpy(dst, src, chunk * sizeof(pgno_t));
+ pgno_t *from = src, *to = src + chunk;
+ mdbx_trace("%s.fill: %u [ %u:%" PRIaPGNO "...%u:%" PRIaPGNO
+ "] @%" PRIaTXN,
+ dbg_prefix_mode, chunk,
+ (unsigned)(from - txn->tw.reclaimed_pglist), from[0],
+ (unsigned)(to - txn->tw.reclaimed_pglist), to[-1], fill_gc_id);
+
+ left -= chunk;
+ if (mdbx_audit_enabled()) {
+ rc = mdbx_audit_ex(txn, retired_stored + amount - left, true);
+ if (unlikely(rc != MDBX_SUCCESS))
+ goto bailout;
+ }
+ if (left == 0) {
+ rc = MDBX_SUCCESS;
+ break;
+ }
+
+ if (txn->tw.lifo_reclaimed == nullptr) {
+ mdbx_tassert(txn, lifo == 0);
+ rc = mdbx_cursor_next(&mc, &key, &data, MDBX_NEXT);
+ if (unlikely(rc != MDBX_SUCCESS))
+ goto bailout;
+ } else {
+ mdbx_tassert(txn, lifo != 0);
+ }
+ }
+ }
+
+ mdbx_tassert(txn, rc == MDBX_SUCCESS);
+ if (unlikely(txn->tw.loose_count != 0 ||
+ filled_gc_slot !=
+ (txn->tw.lifo_reclaimed
+ ? (unsigned)MDBX_PNL_SIZE(txn->tw.lifo_reclaimed)
+ : 0))) {
+ mdbx_notice("** restart: reserve excess (filled-slot %u, loose-count %u)",
+ filled_gc_slot, txn->tw.loose_count);
+ goto retry;
+ }
+
+ mdbx_tassert(txn,
+ txn->tw.lifo_reclaimed == NULL ||
+ cleaned_gc_slot == MDBX_PNL_SIZE(txn->tw.lifo_reclaimed));
+
+bailout:
+ txn->mt_cursors[FREE_DBI] = mc.mc_next;
+
+bailout_notracking:
+ MDBX_PNL_SIZE(txn->tw.reclaimed_pglist) = 0;
+ mdbx_trace("<<< %u loops, rc = %d", loop, rc);
+ return rc;
+}
+
+static int mdbx_flush_iov(MDBX_txn *const txn, struct iovec *iov,
+ unsigned iov_items, size_t iov_off,
+ size_t iov_bytes) {
+ MDBX_env *const env = txn->mt_env;
+ int rc = mdbx_pwritev(env->me_fd, iov, iov_items, iov_off, iov_bytes);
+ if (unlikely(rc != MDBX_SUCCESS)) {
+ mdbx_error("Write error: %s", mdbx_strerror(rc));
+ txn->mt_flags |= MDBX_TXN_ERROR;
+ }
+
+ for (unsigned i = 0; i < iov_items; i++)
+ mdbx_dpage_free(env, (MDBX_page *)iov[i].iov_base,
+ bytes2pgno(env, iov[i].iov_len));
+
+ return rc;
+}
+
+/* Flush (some) dirty pages to the map, after clearing their dirty flag.
+ * [in] txn the transaction that's being committed
+ * [in] keep number of initial pages in dirtylist to keep dirty.
+ * Returns 0 on success, non-zero on failure. */
+static int mdbx_page_flush(MDBX_txn *txn, const unsigned keep) {
+ struct iovec iov[MDBX_COMMIT_PAGES];
+ const MDBX_DPL dl = (keep || txn->tw.loose_count > 1)
+ ? mdbx_dpl_sort(txn->tw.dirtylist)
+ : txn->tw.dirtylist;
+ MDBX_env *const env = txn->mt_env;
+ pgno_t flush_begin = MAX_PAGENO;
+ pgno_t flush_end = MIN_PAGENO;
+ unsigned iov_items = 0;
+ size_t iov_bytes = 0;
+ size_t iov_off = 0;
+ unsigned r, w;
+ for (r = w = keep; ++r <= dl->length;) {
+ MDBX_page *dp = dl[r].ptr;
+ mdbx_tassert(txn,
+ dp->mp_pgno >= MIN_PAGENO && dp->mp_pgno < txn->mt_next_pgno);
+ mdbx_tassert(txn, dp->mp_flags & P_DIRTY);
+
+ /* Don't flush this page yet */
+ if (dp->mp_flags & (P_LOOSE | P_KEEP)) {
+ dp->mp_flags &= ~P_KEEP;
+ dl[++w] = dl[r];
+ continue;
+ }
+
+ const unsigned npages = IS_OVERFLOW(dp) ? dp->mp_pages : 1;
+ flush_begin = (flush_begin < dp->mp_pgno) ? flush_begin : dp->mp_pgno;
+ flush_end =
+ (flush_end > dp->mp_pgno + npages) ? flush_end : dp->mp_pgno + npages;
+ *env->me_unsynced_pages += npages;
+ dp->mp_flags &= ~P_DIRTY;
+ dp->mp_validator = 0 /* TODO */;
+
+ if ((env->me_flags & MDBX_WRITEMAP) == 0) {
+ const size_t size = pgno2bytes(env, npages);
+ if (iov_off + iov_bytes != pgno2bytes(env, dp->mp_pgno) ||
+ iov_items == ARRAY_LENGTH(iov) || iov_bytes + size > MAX_WRITE) {
+ if (iov_items) {
+ int rc = mdbx_flush_iov(txn, iov, iov_items, iov_off, iov_bytes);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+#if MDBX_CPU_CACHE_MMAP_NONCOHERENT
+#if defined(__linux__) || defined(__gnu_linux__)
+ if (mdbx_linux_kernel_version >= 0x02060b00)
+ /* Linux kernels older than version 2.6.11 ignore the addr and nbytes
+ * arguments, making this function fairly expensive. Therefore, the
+ * whole cache is always flushed. */
+#endif /* Linux */
+ mdbx_invalidate_mmap_noncoherent_cache(env->me_map + iov_off,
+ iov_bytes);
+#endif /* MDBX_CPU_CACHE_MMAP_NONCOHERENT */
+ iov_items = 0;
+ iov_bytes = 0;
+ }
+ iov_off = pgno2bytes(env, dp->mp_pgno);
+ }
+ iov[iov_items].iov_base = dp;
+ iov[iov_items].iov_len = size;
+ iov_items += 1;
+ iov_bytes += size;
+ }
+ }
+
+ if (iov_items) {
+ int rc = mdbx_flush_iov(txn, iov, iov_items, iov_off, iov_bytes);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+ }
+
+#if MDBX_CPU_CACHE_MMAP_NONCOHERENT && \
+ (defined(__linux__) || defined(__gnu_linux__))
+ if ((env->me_flags & MDBX_WRITEMAP) == 0 &&
+ mdbx_linux_kernel_version < 0x02060b00)
+ /* Linux kernels older than version 2.6.11 ignore the addr and nbytes
+ * arguments, making this function fairly expensive. Therefore, the
+ * whole cache is always flushed. */
+ mdbx_invalidate_mmap_noncoherent_cache(
+ env->me_map + pgno2bytes(env, flush_begin),
+ pgno2bytes(env, flush_end - flush_begin));
+#endif /* MDBX_CPU_CACHE_MMAP_NONCOHERENT && Linux */
+
+ /* TODO: use flush_begin & flush_end for msync() & sync_file_range(). */
+ (void)flush_begin;
+ (void)flush_end;
+
+ txn->tw.dirtyroom += r - 1 - w;
+ dl->length = w;
+ mdbx_tassert(txn, txn->mt_parent ||
+ txn->tw.dirtyroom + txn->tw.dirtylist->length ==
+ MDBX_DPL_TXNFULL);
+ return MDBX_SUCCESS;
+}
+
+/* Check for misused dbi handles */
+#define TXN_DBI_CHANGED(txn, dbi) \
+ ((txn)->mt_dbiseqs[dbi] != (txn)->mt_env->me_dbiseqs[dbi])
+
+/* Import DBI which opened after txn started into context */
+static __cold bool mdbx_txn_import_dbi(MDBX_txn *txn, MDBX_dbi dbi) {
+ MDBX_env *env = txn->mt_env;
+ if (dbi < CORE_DBS || dbi >= env->me_numdbs)
+ return false;
+
+ mdbx_ensure(env, mdbx_fastmutex_acquire(&env->me_dbi_lock) == MDBX_SUCCESS);
+ const unsigned snap_numdbs = env->me_numdbs;
+ mdbx_compiler_barrier();
+ for (unsigned i = CORE_DBS; i < snap_numdbs; ++i) {
+ if (i >= txn->mt_numdbs)
+ txn->mt_dbflags[i] = 0;
+ if (!(txn->mt_dbflags[i] & DB_USRVALID) &&
+ (env->me_dbflags[i] & MDBX_VALID)) {
+ txn->mt_dbs[i].md_flags = env->me_dbflags[i] & PERSISTENT_FLAGS;
+ txn->mt_dbflags[i] = DB_VALID | DB_USRVALID | DB_STALE;
+ mdbx_tassert(txn, txn->mt_dbxs[i].md_cmp != NULL);
+ }
+ }
+ txn->mt_numdbs = snap_numdbs;
+
+ mdbx_ensure(env, mdbx_fastmutex_release(&env->me_dbi_lock) == MDBX_SUCCESS);
+ return txn->mt_dbflags[dbi] & DB_USRVALID;
+}
+
+/* Check txn and dbi arguments to a function */
+static __inline bool TXN_DBI_EXIST(MDBX_txn *txn, MDBX_dbi dbi,
+ unsigned validity) {
+ if (likely(dbi < txn->mt_numdbs && (txn->mt_dbflags[dbi] & validity)))
+ return true;
+
+ return mdbx_txn_import_dbi(txn, dbi);
+}
+
+int mdbx_txn_commit(MDBX_txn *txn) {
+ int rc = check_txn(txn, MDBX_TXN_BLOCKED - MDBX_TXN_HAS_CHILD);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ MDBX_env *env = txn->mt_env;
+#if MDBX_TXN_CHECKPID
+ if (unlikely(env->me_pid != mdbx_getpid())) {
+ env->me_flags |= MDBX_FATAL_ERROR;
+ return MDBX_PANIC;
+ }
+#endif /* MDBX_TXN_CHECKPID */
+
+ /* mdbx_txn_end() mode for a commit which writes nothing */
+ unsigned end_mode =
+ MDBX_END_EMPTY_COMMIT | MDBX_END_UPDATE | MDBX_END_SLOT | MDBX_END_FREE;
+ if (unlikely(F_ISSET(txn->mt_flags, MDBX_RDONLY)))
+ goto done;
+
+ if (txn->mt_child) {
+ rc = mdbx_txn_commit(txn->mt_child);
+ mdbx_tassert(txn, txn->mt_child == NULL);
+ if (unlikely(rc != MDBX_SUCCESS))
+ goto fail;
+ }
+
+ if (unlikely(txn != env->me_txn)) {
+ mdbx_debug("%s", "attempt to commit unknown transaction");
+ rc = MDBX_EINVAL;
+ goto fail;
+ }
+
+ if (txn->mt_parent) {
+ MDBX_txn *const parent = txn->mt_parent;
+ mdbx_tassert(txn, mdbx_dirtylist_check(txn));
+
+ /* Preserve space for spill list to avoid parent's state corruption
+ * if allocation fails. */
+ if (txn->tw.spill_pages && parent->tw.spill_pages) {
+ rc = mdbx_pnl_need(&parent->tw.spill_pages,
+ MDBX_PNL_SIZE(txn->tw.spill_pages));
+ if (unlikely(rc != MDBX_SUCCESS))
+ goto fail;
+ }
+
+ //-------------------------------------------------------------------------
+
+ parent->tw.lifo_reclaimed = txn->tw.lifo_reclaimed;
+ txn->tw.lifo_reclaimed = NULL;
+
+ parent->tw.retired_pages = txn->tw.retired_pages;
+ txn->tw.retired_pages = NULL;
+
+ mdbx_pnl_free(parent->tw.reclaimed_pglist);
+ parent->tw.reclaimed_pglist = txn->tw.reclaimed_pglist;
+ txn->tw.reclaimed_pglist = NULL;
+ parent->tw.last_reclaimed = txn->tw.last_reclaimed;
+
+ parent->mt_geo = txn->mt_geo;
+ parent->mt_canary = txn->mt_canary;
+ parent->mt_flags = txn->mt_flags;
+
+ /* Merge our cursors into parent's and close them */
+ mdbx_cursors_eot(txn, 1);
+
+ /* Update parent's DB table. */
+ memcpy(parent->mt_dbs, txn->mt_dbs, txn->mt_numdbs * sizeof(MDBX_db));
+ parent->mt_numdbs = txn->mt_numdbs;
+ parent->mt_dbflags[FREE_DBI] = txn->mt_dbflags[FREE_DBI];
+ parent->mt_dbflags[MAIN_DBI] = txn->mt_dbflags[MAIN_DBI];
+ for (unsigned i = CORE_DBS; i < txn->mt_numdbs; i++) {
+ /* preserve parent's DB_NEW status */
+ parent->mt_dbflags[i] =
+ txn->mt_dbflags[i] | (parent->mt_dbflags[i] & (DB_CREAT | DB_FRESH));
+ }
+
+ /* Remove refunded pages from parent's dirty & spill lists */
+ MDBX_DPL dst = mdbx_dpl_sort(parent->tw.dirtylist);
+ while (dst->length && dst[dst->length].pgno >= parent->mt_next_pgno) {
+ MDBX_page *mp = dst[dst->length].ptr;
+ if (mp && (txn->mt_env->me_flags & MDBX_WRITEMAP) == 0)
+ mdbx_dpage_free(txn->mt_env, mp, IS_OVERFLOW(mp) ? mp->mp_pages : 1);
+ dst->length -= 1;
+ }
+ parent->tw.dirtyroom += dst->sorted - dst->length;
+ dst->sorted = dst->length;
+ mdbx_tassert(parent,
+ parent->mt_parent ||
+ parent->tw.dirtyroom + parent->tw.dirtylist->length ==
+ MDBX_DPL_TXNFULL);
+
+ if (parent->tw.spill_pages && MDBX_PNL_SIZE(parent->tw.spill_pages) > 0 &&
+ MDBX_PNL_MOST(parent->tw.spill_pages) >= parent->mt_next_pgno << 1) {
+ const MDBX_PNL ps = parent->tw.spill_pages;
+#if MDBX_PNL_ASCENDING
+ unsigned i = MDBX_PNL_SIZE(ps);
+ assert(MDBX_PNL_MOST(ps) == MDBX_PNL_LAST(ps));
+ do
+ i -= 1;
+ while (i && ps[i] >= parent->mt_next_pgno << 1);
+ MDBX_PNL_SIZE(ps) = i;
+#else
+ assert(MDBX_PNL_MOST(ps) == MDBX_PNL_FIRST(ps));
+ unsigned i = 1, len = MDBX_PNL_SIZE(ps);
+ while (i < len && ps[i + 1] >= parent->mt_next_pgno << 1)
+ ++i;
+ MDBX_PNL_SIZE(ps) = len -= i;
+ for (unsigned k = 1; k <= len; ++k)
+ ps[k] = ps[k + i];
+#endif
+ }
+
+ /* Remove anything in our dirty list from parent's spill list */
+ MDBX_DPL src = mdbx_dpl_sort(txn->tw.dirtylist);
+ if (likely(src->length > 0) && parent->tw.spill_pages &&
+ MDBX_PNL_SIZE(parent->tw.spill_pages) > 0) {
+ MDBX_PNL sp = parent->tw.spill_pages;
+ assert(mdbx_pnl_check4assert(sp, txn->mt_next_pgno));
+
+ const unsigned len = MDBX_PNL_SIZE(parent->tw.spill_pages);
+ MDBX_PNL_SIZE(sp) = ~(pgno_t)0;
+
+ /* Mark our dirty pages as deleted in parent spill list */
+ unsigned r, w, i = 1;
+ w = r = len;
+ do {
+ pgno_t pn = src[i].pgno << 1;
+ while (pn > sp[r])
+ r--;
+ if (pn == sp[r]) {
+ sp[r] = 1;
+ w = --r;
+ }
+ } while (++i <= src->length);
+
+ /* Squash deleted pagenums if we deleted any */
+ for (r = w; ++r <= len;)
+ if ((sp[r] & 1) == 0)
+ sp[++w] = sp[r];
+ MDBX_PNL_SIZE(sp) = w;
+ assert(mdbx_pnl_check4assert(sp, txn->mt_next_pgno << 1));
+ }
+
+ /* Remove anything in our spill list from parent's dirty list */
+ if (txn->tw.spill_pages && MDBX_PNL_SIZE(txn->tw.spill_pages) > 0) {
+ const MDBX_PNL sp = txn->tw.spill_pages;
+ mdbx_pnl_sort(sp);
+ /* Scanning in ascend order */
+ const int step = MDBX_PNL_ASCENDING ? 1 : -1;
+ const int begin = MDBX_PNL_ASCENDING ? 1 : MDBX_PNL_SIZE(sp);
+ const int end = MDBX_PNL_ASCENDING ? MDBX_PNL_SIZE(sp) + 1 : 0;
+ mdbx_tassert(txn, sp[begin] <= sp[end - step]);
+
+ unsigned r, w = r = mdbx_dpl_search(dst, sp[begin] >> 1);
+ mdbx_tassert(txn, dst->sorted == dst->length);
+ for (int i = begin; r <= dst->length;) {
+ mdbx_tassert(txn, (sp[i] & 1) == 0);
+ const pgno_t pgno = sp[i] >> 1;
+ if (dst[r].pgno < pgno) {
+ dst[w++] = dst[r++];
+ } else if (dst[r].pgno > pgno) {
+ i += step;
+ if (i == end)
+ while (r <= dst->length)
+ dst[w++] = dst[r++];
+ } else {
+ MDBX_page *dp = dst[r++].ptr;
+ if ((env->me_flags & MDBX_WRITEMAP) == 0)
+ mdbx_dpage_free(env, dp, IS_OVERFLOW(dp) ? dp->mp_pages : 1);
+ }
+ }
+ mdbx_tassert(txn, r == dst->length + 1);
+ dst->length = w;
+ parent->tw.dirtyroom += r - w;
+ }
+ assert(dst->sorted == dst->length);
+ mdbx_tassert(parent,
+ parent->mt_parent ||
+ parent->tw.dirtyroom + parent->tw.dirtylist->length ==
+ MDBX_DPL_TXNFULL);
+
+ unsigned d, s, l;
+ /* Find length of merging our dirty list with parent's */
+ for (l = 0, d = dst->length, s = src->length; d > 0 && s > 0; ++l) {
+ const pgno_t s_pgno = src[s].pgno;
+ const pgno_t d_pgno = dst[d].pgno;
+ d -= d_pgno >= s_pgno;
+ s -= d_pgno <= s_pgno;
+ }
+ assert(dst->sorted == dst->length);
+ dst->sorted = l += d + s;
+ assert(dst->sorted >= dst->length);
+ parent->tw.dirtyroom -= dst->sorted - dst->length;
+
+ /* Merge our dirty list into parent's */
+ for (d = dst->length, s = src->length; d > 0 && s > 0; --l) {
+ if (dst[d].pgno > src[s].pgno)
+ dst[l] = dst[d--];
+ else if (dst[d].pgno < src[s].pgno)
+ dst[l] = src[s--];
+ else {
+ MDBX_page *dp = dst[d--].ptr;
+ if (dp && (env->me_flags & MDBX_WRITEMAP) == 0)
+ mdbx_dpage_free(env, dp, IS_OVERFLOW(dp) ? dp->mp_pgno : 1);
+ dst[l] = src[s--];
+ }
+ }
+ if (s) {
+ do
+ dst[l--] = src[s--];
+ while (s > 0);
+ } else if (d) {
+ do
+ dst[l--] = dst[d--];
+ while (d > 0);
+ }
+ assert(l == 0);
+ dst->length = dst->sorted;
+ mdbx_free(txn->tw.dirtylist);
+ txn->tw.dirtylist = nullptr;
+ mdbx_tassert(parent,
+ parent->mt_parent ||
+ parent->tw.dirtyroom + parent->tw.dirtylist->length ==
+ MDBX_DPL_TXNFULL);
+
+ if (txn->tw.spill_pages) {
+ if (parent->tw.spill_pages) {
+ /* Must not fail since space was preserved above. */
+ rc = mdbx_pnl_append_list(&parent->tw.spill_pages, txn->tw.spill_pages);
+ mdbx_assert(env, rc == MDBX_SUCCESS);
+ (void)rc;
+ mdbx_pnl_free(txn->tw.spill_pages);
+ mdbx_pnl_sort(parent->tw.spill_pages);
+ } else {
+ parent->tw.spill_pages = txn->tw.spill_pages;
+ }
+ }
+ if (parent->tw.spill_pages)
+ assert(mdbx_pnl_check4assert(parent->tw.spill_pages,
+ parent->mt_next_pgno << 1));
+
+ /* Append our loose page list to parent's */
+ if (txn->tw.loose_pages) {
+ MDBX_page **lp = &parent->tw.loose_pages;
+ while (*lp)
+ lp = &(*lp)->mp_next;
+ *lp = txn->tw.loose_pages;
+ parent->tw.loose_count += txn->tw.loose_count;
+ }
+ if (txn->tw.retired2parent_pages) {
+ MDBX_page *mp = txn->tw.retired2parent_pages;
+ do {
+ MDBX_page *next = mp->mp_next;
+ rc = mdbx_page_loose(parent, mp);
+ if (unlikely(rc != MDBX_SUCCESS))
+ goto fail;
+ mp = next;
+ } while (mp);
+ }
+
+ env->me_txn = parent;
+ parent->mt_child = NULL;
+ txn->mt_signature = 0;
+ mdbx_free(txn);
+ mdbx_tassert(parent, mdbx_dirtylist_check(parent));
+
+ /* Scan parent's loose page for suitable for refund */
+ for (MDBX_page *mp = parent->tw.loose_pages; mp; mp = mp->mp_next) {
+ if (mp->mp_pgno == parent->mt_next_pgno - 1) {
+ mdbx_refund(parent);
+ break;
+ }
+ }
+ mdbx_tassert(parent, mdbx_dirtylist_check(parent));
+ return MDBX_SUCCESS;
+ }
+
+ mdbx_tassert(txn, txn->tw.dirtyroom + txn->tw.dirtylist->length ==
+ MDBX_DPL_TXNFULL);
+ mdbx_cursors_eot(txn, 0);
+ end_mode |= MDBX_END_EOTDONE;
+
+ if (txn->tw.dirtylist->length == 0 &&
+ (txn->mt_flags & (MDBX_TXN_DIRTY | MDBX_TXN_SPILLS)) == 0)
+ goto done;
+
+ mdbx_debug("committing txn %" PRIaTXN " %p on mdbenv %p, root page %" PRIaPGNO
+ "/%" PRIaPGNO,
+ txn->mt_txnid, (void *)txn, (void *)env,
+ txn->mt_dbs[MAIN_DBI].md_root, txn->mt_dbs[FREE_DBI].md_root);
+
+ /* Update DB root pointers */
+ if (txn->mt_numdbs > CORE_DBS) {
+ MDBX_cursor mc;
+ MDBX_val data;
+ data.iov_len = sizeof(MDBX_db);
+
+ rc = mdbx_cursor_init(&mc, txn, MAIN_DBI);
+ if (unlikely(rc != MDBX_SUCCESS))
+ goto fail;
+ for (MDBX_dbi i = CORE_DBS; i < txn->mt_numdbs; i++) {
+ if (txn->mt_dbflags[i] & DB_DIRTY) {
+ if (unlikely(TXN_DBI_CHANGED(txn, i))) {
+ rc = MDBX_BAD_DBI;
+ goto fail;
+ }
+ MDBX_db *db = &txn->mt_dbs[i];
+ db->md_mod_txnid = txn->mt_txnid;
+ data.iov_base = db;
+ WITH_CURSOR_TRACKING(mc,
+ rc = mdbx_cursor_put(&mc, &txn->mt_dbxs[i].md_name,
+ &data, F_SUBDATA));
+ if (unlikely(rc != MDBX_SUCCESS))
+ goto fail;
+ }
+ }
+ }
+
+ rc = mdbx_update_gc(txn);
+ if (unlikely(rc != MDBX_SUCCESS))
+ goto fail;
+
+ if (mdbx_audit_enabled()) {
+ rc = mdbx_audit_ex(txn, MDBX_PNL_SIZE(txn->tw.retired_pages), true);
+ if (unlikely(rc != MDBX_SUCCESS))
+ goto fail;
+ }
+
+ rc = mdbx_page_flush(txn, 0);
+ if (likely(rc == MDBX_SUCCESS)) {
+ if (txn->mt_dbs[MAIN_DBI].md_flags & DB_DIRTY)
+ txn->mt_dbs[MAIN_DBI].md_mod_txnid = txn->mt_txnid;
+
+ MDBX_meta meta, *head = mdbx_meta_head(env);
+ meta.mm_magic_and_version = head->mm_magic_and_version;
+ meta.mm_extra_flags = head->mm_extra_flags;
+ meta.mm_validator_id = head->mm_validator_id;
+ meta.mm_extra_pagehdr = head->mm_extra_pagehdr;
+ meta.mm_pages_retired =
+ head->mm_pages_retired + MDBX_PNL_SIZE(txn->tw.retired_pages);
+
+ meta.mm_geo = txn->mt_geo;
+ meta.mm_dbs[FREE_DBI] = txn->mt_dbs[FREE_DBI];
+ meta.mm_dbs[MAIN_DBI] = txn->mt_dbs[MAIN_DBI];
+ meta.mm_canary = txn->mt_canary;
+ mdbx_meta_set_txnid(env, &meta, txn->mt_txnid);
+
+ rc = mdbx_sync_locked(
+ env, env->me_flags | txn->mt_flags | MDBX_SHRINK_ALLOWED, &meta);
+ }
+ if (unlikely(rc != MDBX_SUCCESS)) {
+ env->me_flags |= MDBX_FATAL_ERROR;
+ goto fail;
+ }
+
+ if (likely(env->me_lck))
+ env->me_lck->mti_readers_refresh_flag = false;
+ end_mode = MDBX_END_COMMITTED | MDBX_END_UPDATE | MDBX_END_EOTDONE;
+
+done:
+ return mdbx_txn_end(txn, end_mode);
+
+fail:
+ mdbx_txn_abort(txn);
+ return rc;
+}
+
+/* Read the environment parameters of a DB environment
+ * before mapping it into memory. */
+static int __cold mdbx_read_header(MDBX_env *env, MDBX_meta *dest,
+ uint64_t *filesize) {
+ int rc = mdbx_filesize(env->me_fd, filesize);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ memset(dest, 0, sizeof(MDBX_meta));
+ dest->mm_datasync_sign = MDBX_DATASIGN_WEAK;
+ rc = MDBX_CORRUPTED;
+
+ /* Read twice all meta pages so we can find the latest one. */
+ unsigned loop_limit = NUM_METAS * 2;
+ for (unsigned loop_count = 0; loop_count < loop_limit; ++loop_count) {
+ /* We don't know the page size on first time.
+ * So, just guess it. */
+ unsigned guess_pagesize = dest->mm_psize;
+ if (guess_pagesize == 0)
+ guess_pagesize =
+ (loop_count > NUM_METAS) ? env->me_psize : env->me_os_psize;
+
+ const unsigned meta_number = loop_count % NUM_METAS;
+ const unsigned offset = guess_pagesize * meta_number;
+
+ char buffer[MIN_PAGESIZE];
+ unsigned retryleft = 42;
+ while (1) {
+ mdbx_trace("reading meta[%d]: offset %u, bytes %u, retry-left %u",
+ meta_number, offset, MIN_PAGESIZE, retryleft);
+ int err = mdbx_pread(env->me_fd, buffer, MIN_PAGESIZE, offset);
+ if (err != MDBX_SUCCESS) {
+ if (err == MDBX_ENODATA && offset == 0 && loop_count == 0 &&
+ *filesize == 0 && (env->me_flags & MDBX_RDONLY) == 0)
+ mdbx_notice("read meta: empty file (%d, %s)", err,
+ mdbx_strerror(err));
+ else
+ mdbx_error("read meta[%u,%u]: %i, %s", offset, MIN_PAGESIZE, err,
+ mdbx_strerror(err));
+ return err;
+ }
+
+ char again[MIN_PAGESIZE];
+ err = mdbx_pread(env->me_fd, again, MIN_PAGESIZE, offset);
+ if (err != MDBX_SUCCESS) {
+ mdbx_error("read meta[%u,%u]: %i, %s", offset, MIN_PAGESIZE, err,
+ mdbx_strerror(err));
+ return err;
+ }
+
+ if (memcmp(buffer, again, MIN_PAGESIZE) == 0 || --retryleft == 0)
+ break;
+
+ mdbx_verbose("meta[%u] was updated, re-read it", meta_number);
+ }
+
+ MDBX_page *const page = (MDBX_page *)buffer;
+ MDBX_meta *const meta = page_meta(page);
+ if (meta->mm_magic_and_version != MDBX_DATA_MAGIC &&
+ meta->mm_magic_and_version != MDBX_DATA_MAGIC_DEVEL) {
+ mdbx_error("meta[%u] has invalid magic/version %" PRIx64, meta_number,
+ meta->mm_magic_and_version);
+ return ((meta->mm_magic_and_version >> 8) != MDBX_MAGIC)
+ ? MDBX_INVALID
+ : MDBX_VERSION_MISMATCH;
+ }
+
+ if (page->mp_pgno != meta_number) {
+ mdbx_error("meta[%u] has invalid pageno %" PRIaPGNO, meta_number,
+ page->mp_pgno);
+ return MDBX_INVALID;
+ }
+
+ if (page->mp_flags != P_META) {
+ mdbx_error("page #%u not a meta-page", meta_number);
+ return MDBX_INVALID;
+ }
+
+ if (!retryleft) {
+ mdbx_error("meta[%u] is too volatile, skip it", meta_number);
+ continue;
+ }
+
+ /* LY: check pagesize */
+ if (!is_powerof2(meta->mm_psize) || meta->mm_psize < MIN_PAGESIZE ||
+ meta->mm_psize > MAX_PAGESIZE) {
+ mdbx_notice("meta[%u] has invalid pagesize (%u), skip it", meta_number,
+ meta->mm_psize);
+ rc = is_powerof2(meta->mm_psize) ? MDBX_VERSION_MISMATCH : MDBX_INVALID;
+ continue;
+ }
+
+ if (meta_number == 0 && guess_pagesize != meta->mm_psize) {
+ dest->mm_psize = meta->mm_psize;
+ mdbx_verbose("meta[%u] took pagesize %u", meta_number, meta->mm_psize);
+ }
+
+ if (safe64_read(&meta->mm_txnid_a) != safe64_read(&meta->mm_txnid_b)) {
+ mdbx_warning("meta[%u] not completely updated, skip it", meta_number);
+ continue;
+ }
+
+ /* LY: check signature as a checksum */
+ if (META_IS_STEADY(meta) &&
+ meta->mm_datasync_sign != mdbx_meta_sign(meta)) {
+ mdbx_notice("meta[%u] has invalid steady-checksum (0x%" PRIx64
+ " != 0x%" PRIx64 "), skip it",
+ meta_number, meta->mm_datasync_sign, mdbx_meta_sign(meta));
+ continue;
+ }
+
+ mdbx_debug("read meta%" PRIaPGNO " = root %" PRIaPGNO "/%" PRIaPGNO
+ ", geo %" PRIaPGNO "/%" PRIaPGNO "-%" PRIaPGNO "/%" PRIaPGNO
+ " +%u -%u, txn_id %" PRIaTXN ", %s",
+ page->mp_pgno, meta->mm_dbs[MAIN_DBI].md_root,
+ meta->mm_dbs[FREE_DBI].md_root, meta->mm_geo.lower,
+ meta->mm_geo.next, meta->mm_geo.now, meta->mm_geo.upper,
+ meta->mm_geo.grow, meta->mm_geo.shrink,
+ meta->mm_txnid_a.inconsistent, mdbx_durable_str(meta));
+
+ /* LY: check min-pages value */
+ if (meta->mm_geo.lower < MIN_PAGENO || meta->mm_geo.lower > MAX_PAGENO) {
+ mdbx_notice("meta[%u] has invalid min-pages (%" PRIaPGNO "), skip it",
+ meta_number, meta->mm_geo.lower);
+ rc = MDBX_INVALID;
+ continue;
+ }
+
+ /* LY: check max-pages value */
+ if (meta->mm_geo.upper < MIN_PAGENO || meta->mm_geo.upper > MAX_PAGENO ||
+ meta->mm_geo.upper < meta->mm_geo.lower) {
+ mdbx_notice("meta[%u] has invalid max-pages (%" PRIaPGNO "), skip it",
+ meta_number, meta->mm_geo.upper);
+ rc = MDBX_INVALID;
+ continue;
+ }
+
+ /* LY: check last_pgno */
+ if (meta->mm_geo.next < MIN_PAGENO || meta->mm_geo.next - 1 > MAX_PAGENO) {
+ mdbx_notice("meta[%u] has invalid next-pageno (%" PRIaPGNO "), skip it",
+ meta_number, meta->mm_geo.next);
+ rc = MDBX_CORRUPTED;
+ continue;
+ }
+
+ /* LY: check filesize & used_bytes */
+ const uint64_t used_bytes = meta->mm_geo.next * (uint64_t)meta->mm_psize;
+ if (used_bytes > *filesize) {
+ /* Here could be a race with DB-shrinking performed by other process */
+ rc = mdbx_filesize(env->me_fd, filesize);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+ if (used_bytes > *filesize) {
+ mdbx_notice("meta[%u] used-bytes (%" PRIu64
+ ") beyond filesize (%" PRIu64 "), skip it",
+ meta_number, used_bytes, *filesize);
+ rc = MDBX_CORRUPTED;
+ continue;
+ }
+ }
+
+ /* LY: check mapsize limits */
+ const uint64_t mapsize_min = meta->mm_geo.lower * (uint64_t)meta->mm_psize;
+ STATIC_ASSERT(MAX_MAPSIZE < PTRDIFF_MAX - MAX_PAGESIZE);
+ STATIC_ASSERT(MIN_MAPSIZE < MAX_MAPSIZE);
+ if (mapsize_min < MIN_MAPSIZE || mapsize_min > MAX_MAPSIZE) {
+ mdbx_notice("meta[%u] has invalid min-mapsize (%" PRIu64 "), skip it",
+ meta_number, mapsize_min);
+ rc = MDBX_VERSION_MISMATCH;
+ continue;
+ }
+
+ const uint64_t mapsize_max = meta->mm_geo.upper * (uint64_t)meta->mm_psize;
+ STATIC_ASSERT(MIN_MAPSIZE < MAX_MAPSIZE);
+ if (mapsize_max > MAX_MAPSIZE ||
+ MAX_PAGENO < roundup_powerof2((size_t)mapsize_max, env->me_os_psize) /
+ (size_t)meta->mm_psize) {
+ if (meta->mm_geo.next - 1 > MAX_PAGENO || used_bytes > MAX_MAPSIZE) {
+ mdbx_notice("meta[%u] has too large max-mapsize (%" PRIu64 "), skip it",
+ meta_number, mapsize_max);
+ rc = MDBX_TOO_LARGE;
+ continue;
+ }
+
+ /* allow to open large DB from a 32-bit environment */
+ mdbx_notice("meta[%u] has too large max-mapsize (%" PRIu64 "), "
+ "but size of used space still acceptable (%" PRIu64 ")",
+ meta_number, mapsize_max, used_bytes);
+ meta->mm_geo.upper = (pgno_t)(MAX_MAPSIZE / meta->mm_psize);
+ }
+
+ /* LY: check and silently put mm_geo.now into [geo.lower...geo.upper].
+ *
+ * Copy-with-compaction by previous version of libmdbx could produce DB-file
+ * less than meta.geo.lower bound, in case actual filling is low or no data
+ * at all. This is not a problem as there is no damage or loss of data.
+ * Therefore it is better not to consider such situation as an error, but
+ * silently correct it. */
+ if (meta->mm_geo.now < meta->mm_geo.lower)
+ meta->mm_geo.now = meta->mm_geo.lower;
+ if (meta->mm_geo.now > meta->mm_geo.upper &&
+ meta->mm_geo.next <= meta->mm_geo.upper)
+ meta->mm_geo.now = meta->mm_geo.upper;
+
+ if (meta->mm_geo.next > meta->mm_geo.now) {
+ mdbx_notice("meta[%u] next-pageno (%" PRIaPGNO
+ ") is beyond end-pgno (%" PRIaPGNO "), skip it",
+ meta_number, meta->mm_geo.next, meta->mm_geo.now);
+ rc = MDBX_CORRUPTED;
+ continue;
+ }
+
+ /* LY: GC root */
+ if (meta->mm_dbs[FREE_DBI].md_root == P_INVALID) {
+ if (meta->mm_dbs[FREE_DBI].md_branch_pages ||
+ meta->mm_dbs[FREE_DBI].md_depth ||
+ meta->mm_dbs[FREE_DBI].md_entries ||
+ meta->mm_dbs[FREE_DBI].md_leaf_pages ||
+ meta->mm_dbs[FREE_DBI].md_overflow_pages) {
+ mdbx_notice("meta[%u] has false-empty GC, skip it", meta_number);
+ rc = MDBX_CORRUPTED;
+ continue;
+ }
+ } else if (meta->mm_dbs[FREE_DBI].md_root >= meta->mm_geo.next) {
+ mdbx_notice("meta[%u] has invalid GC-root %" PRIaPGNO ", skip it",
+ meta_number, meta->mm_dbs[FREE_DBI].md_root);
+ rc = MDBX_CORRUPTED;
+ continue;
+ }
+
+ /* LY: MainDB root */
+ if (meta->mm_dbs[MAIN_DBI].md_root == P_INVALID) {
+ if (meta->mm_dbs[MAIN_DBI].md_branch_pages ||
+ meta->mm_dbs[MAIN_DBI].md_depth ||
+ meta->mm_dbs[MAIN_DBI].md_entries ||
+ meta->mm_dbs[MAIN_DBI].md_leaf_pages ||
+ meta->mm_dbs[MAIN_DBI].md_overflow_pages) {
+ mdbx_notice("meta[%u] has false-empty maindb", meta_number);
+ rc = MDBX_CORRUPTED;
+ continue;
+ }
+ } else if (meta->mm_dbs[MAIN_DBI].md_root >= meta->mm_geo.next) {
+ mdbx_notice("meta[%u] has invalid maindb-root %" PRIaPGNO ", skip it",
+ meta_number, meta->mm_dbs[MAIN_DBI].md_root);
+ rc = MDBX_CORRUPTED;
+ continue;
+ }
+
+ if (safe64_read(&meta->mm_txnid_a) == 0) {
+ mdbx_warning("meta[%u] has zero txnid, skip it", meta_number);
+ continue;
+ }
+
+ if (mdbx_meta_ot(prefer_noweak, env, dest, meta)) {
+ *dest = *meta;
+ if (META_IS_WEAK(dest))
+ loop_limit += 1; /* LY: should re-read to hush race with update */
+ mdbx_verbose("latch meta[%u]", meta_number);
+ }
+ }
+
+ if (META_IS_WEAK(dest)) {
+ mdbx_error("%s", "no usable meta-pages, database is corrupted");
+ return rc;
+ }
+
+ return MDBX_SUCCESS;
+}
+
+static MDBX_page *__cold mdbx_meta_model(const MDBX_env *env, MDBX_page *model,
+ unsigned num) {
+
+ mdbx_ensure(env, is_powerof2(env->me_psize));
+ mdbx_ensure(env, env->me_psize >= MIN_PAGESIZE);
+ mdbx_ensure(env, env->me_psize <= MAX_PAGESIZE);
+ mdbx_ensure(env, env->me_dbgeo.lower >= MIN_MAPSIZE);
+ mdbx_ensure(env, env->me_dbgeo.upper <= MAX_MAPSIZE);
+ mdbx_ensure(env, env->me_dbgeo.now >= env->me_dbgeo.lower);
+ mdbx_ensure(env, env->me_dbgeo.now <= env->me_dbgeo.upper);
+
+ memset(model, 0, sizeof(*model));
+ model->mp_pgno = num;
+ model->mp_flags = P_META;
+ MDBX_meta *const model_meta = page_meta(model);
+ model_meta->mm_magic_and_version = MDBX_DATA_MAGIC;
+
+ model_meta->mm_geo.lower = bytes2pgno(env, env->me_dbgeo.lower);
+ model_meta->mm_geo.upper = bytes2pgno(env, env->me_dbgeo.upper);
+ model_meta->mm_geo.grow = (uint16_t)bytes2pgno(env, env->me_dbgeo.grow);
+ model_meta->mm_geo.shrink = (uint16_t)bytes2pgno(env, env->me_dbgeo.shrink);
+ model_meta->mm_geo.now = bytes2pgno(env, env->me_dbgeo.now);
+ model_meta->mm_geo.next = NUM_METAS;
+
+ mdbx_ensure(env, model_meta->mm_geo.lower >= MIN_PAGENO);
+ mdbx_ensure(env, model_meta->mm_geo.upper <= MAX_PAGENO);
+ mdbx_ensure(env, model_meta->mm_geo.now >= model_meta->mm_geo.lower);
+ mdbx_ensure(env, model_meta->mm_geo.now <= model_meta->mm_geo.upper);
+ mdbx_ensure(env, model_meta->mm_geo.next >= MIN_PAGENO);
+ mdbx_ensure(env, model_meta->mm_geo.next <= model_meta->mm_geo.now);
+ mdbx_ensure(env,
+ model_meta->mm_geo.grow == bytes2pgno(env, env->me_dbgeo.grow));
+ mdbx_ensure(env, model_meta->mm_geo.shrink ==
+ bytes2pgno(env, env->me_dbgeo.shrink));
+
+ model_meta->mm_psize = env->me_psize;
+ model_meta->mm_flags = (uint16_t)env->me_flags;
+ model_meta->mm_flags |=
+ MDBX_INTEGERKEY; /* this is mm_dbs[FREE_DBI].md_flags */
+ model_meta->mm_dbs[FREE_DBI].md_root = P_INVALID;
+ model_meta->mm_dbs[MAIN_DBI].md_root = P_INVALID;
+ mdbx_meta_set_txnid(env, model_meta, MIN_TXNID + num);
+ model_meta->mm_datasync_sign = mdbx_meta_sign(model_meta);
+ return (MDBX_page *)((uint8_t *)model + env->me_psize);
+}
+
+/* Fill in most of the zeroed meta-pages for an empty database environment.
+ * Return pointer to recenly (head) meta-page. */
+static MDBX_meta *__cold mdbx_init_metas(const MDBX_env *env, void *buffer) {
+ MDBX_page *page0 = (MDBX_page *)buffer;
+ MDBX_page *page1 = mdbx_meta_model(env, page0, 0);
+ MDBX_page *page2 = mdbx_meta_model(env, page1, 1);
+ mdbx_meta_model(env, page2, 2);
+ mdbx_assert(env, !mdbx_meta_eq(env, page_meta(page0), page_meta(page1)));
+ mdbx_assert(env, !mdbx_meta_eq(env, page_meta(page1), page_meta(page2)));
+ mdbx_assert(env, !mdbx_meta_eq(env, page_meta(page2), page_meta(page0)));
+ return page_meta(page2);
+}
+
+static int mdbx_sync_locked(MDBX_env *env, unsigned flags,
+ MDBX_meta *const pending) {
+ mdbx_assert(env, ((env->me_flags ^ flags) & MDBX_WRITEMAP) == 0);
+ MDBX_meta *const meta0 = METAPAGE(env, 0);
+ MDBX_meta *const meta1 = METAPAGE(env, 1);
+ MDBX_meta *const meta2 = METAPAGE(env, 2);
+ MDBX_meta *const head = mdbx_meta_head(env);
+
+ mdbx_assert(env, mdbx_meta_eq_mask(env) == 0);
+ mdbx_assert(env,
+ pending < METAPAGE(env, 0) || pending > METAPAGE(env, NUM_METAS));
+ mdbx_assert(env, (env->me_flags & (MDBX_RDONLY | MDBX_FATAL_ERROR)) == 0);
+ mdbx_assert(env, !META_IS_STEADY(head) || *env->me_unsynced_pages != 0);
+ mdbx_assert(env, pending->mm_geo.next <= pending->mm_geo.now);
+
+ if (flags & (MDBX_NOSYNC | MDBX_MAPASYNC)) {
+ /* Check auto-sync conditions */
+ const pgno_t autosync_threshold = *env->me_autosync_threshold;
+ const uint64_t autosync_period = *env->me_autosync_period;
+ if ((autosync_threshold && *env->me_unsynced_pages >= autosync_threshold) ||
+ (autosync_period &&
+ mdbx_osal_monotime() - *env->me_sync_timestamp >= autosync_period))
+ flags &= MDBX_WRITEMAP | MDBX_SHRINK_ALLOWED; /* force steady */
+ }
+
+ pgno_t shrink = 0;
+ if (flags & MDBX_SHRINK_ALLOWED) {
+ /* LY: check conditions to discard unused pages */
+ const pgno_t largest_pgno = mdbx_find_largest(
+ env, (head->mm_geo.next > pending->mm_geo.next) ? head->mm_geo.next
+ : pending->mm_geo.next);
+ mdbx_assert(env, largest_pgno >= NUM_METAS);
+#if defined(MDBX_USE_VALGRIND) || defined(__SANITIZE_ADDRESS__)
+ const pgno_t edge = env->me_poison_edge;
+ if (edge > largest_pgno) {
+ env->me_poison_edge = largest_pgno;
+ VALGRIND_MAKE_MEM_NOACCESS(env->me_map + pgno2bytes(env, largest_pgno),
+ pgno2bytes(env, edge - largest_pgno));
+ ASAN_POISON_MEMORY_REGION(env->me_map + pgno2bytes(env, largest_pgno),
+ pgno2bytes(env, edge - largest_pgno));
+ }
+#endif /* MDBX_USE_VALGRIND */
+#if defined(MADV_DONTNEED)
+ const size_t largest_aligned2os_bytes =
+ pgno_align2os_bytes(env, largest_pgno);
+ const pgno_t largest_aligned2os_pgno =
+ bytes2pgno(env, largest_aligned2os_bytes);
+ const pgno_t prev_discarded_pgno = *env->me_discarded_tail;
+ if (prev_discarded_pgno >
+ largest_aligned2os_pgno +
+ /* 1M threshold to avoid unreasonable madvise() call */
+ bytes2pgno(env, MEGABYTE)) {
+ mdbx_notice("open-MADV_%s %u..%u", "DONTNEED", *env->me_discarded_tail,
+ largest_pgno);
+ *env->me_discarded_tail = largest_aligned2os_pgno;
+ const size_t prev_discarded_bytes =
+ pgno2bytes(env, prev_discarded_pgno) & ~(env->me_os_psize - 1);
+ mdbx_ensure(env, prev_discarded_bytes > largest_aligned2os_bytes);
+ int advise = MADV_DONTNEED;
+#if defined(MADV_FREE) && \
+ 0 /* MADV_FREE works for only anon vma at the moment */
+ if ((env->me_flags & MDBX_WRITEMAP) &&
+ mdbx_linux_kernel_version > 0x04050000)
+ advise = MADV_FREE;
+#endif /* MADV_FREE */
+ int err = madvise(env->me_map + largest_aligned2os_bytes,
+ prev_discarded_bytes - largest_aligned2os_bytes, advise)
+ ? errno
+ : MDBX_SUCCESS;
+ mdbx_assert(env, err == MDBX_SUCCESS);
+ (void)err;
+ }
+#endif /* MADV_FREE || MADV_DONTNEED */
+
+ /* LY: check conditions to shrink datafile */
+ const pgno_t backlog_gap =
+ pending->mm_dbs[FREE_DBI].md_depth + mdbx_backlog_extragap(env);
+ if (pending->mm_geo.shrink && pending->mm_geo.now - pending->mm_geo.next >
+ pending->mm_geo.shrink + backlog_gap) {
+ if (pending->mm_geo.now > largest_pgno &&
+ pending->mm_geo.now - largest_pgno >
+ pending->mm_geo.shrink + backlog_gap) {
+ const pgno_t aligner = pending->mm_geo.grow ? pending->mm_geo.grow
+ : pending->mm_geo.shrink;
+ const pgno_t with_backlog_gap = largest_pgno + backlog_gap;
+ const pgno_t aligned = pgno_align2os_pgno(
+ env, with_backlog_gap + aligner - with_backlog_gap % aligner);
+ const pgno_t bottom =
+ (aligned > pending->mm_geo.lower) ? aligned : pending->mm_geo.lower;
+ if (pending->mm_geo.now > bottom) {
+ flags &= MDBX_WRITEMAP | MDBX_SHRINK_ALLOWED; /* force steady */
+ shrink = pending->mm_geo.now - bottom;
+ pending->mm_geo.now = bottom;
+ if (mdbx_meta_txnid_stable(env, head) ==
+ pending->mm_txnid_a.inconsistent)
+ mdbx_meta_set_txnid(
+ env, pending,
+ safe64_txnid_next(pending->mm_txnid_a.inconsistent));
+ }
+ }
+ }
+ }
+
+ /* LY: step#1 - sync previously written/updated data-pages */
+ int rc = *env->me_unsynced_pages ? MDBX_RESULT_TRUE /* carry non-steady */
+ : MDBX_RESULT_FALSE /* carry steady */;
+ if (rc != MDBX_RESULT_FALSE && (flags & MDBX_NOSYNC) == 0) {
+ mdbx_assert(env, ((flags ^ env->me_flags) & MDBX_WRITEMAP) == 0);
+ MDBX_meta *const recent_steady_meta = mdbx_meta_steady(env);
+ if (flags & MDBX_WRITEMAP) {
+ const size_t usedbytes = pgno_align2os_bytes(env, pending->mm_geo.next);
+ rc = mdbx_msync(&env->me_dxb_mmap, 0, usedbytes, flags & MDBX_MAPASYNC);
+ if (unlikely(rc != MDBX_SUCCESS))
+ goto fail;
+ rc = MDBX_RESULT_TRUE /* carry non-steady */;
+ if ((flags & MDBX_MAPASYNC) == 0) {
+ if (unlikely(pending->mm_geo.next > recent_steady_meta->mm_geo.now)) {
+ rc = mdbx_filesync(env->me_fd, MDBX_SYNC_SIZE);
+ if (unlikely(rc != MDBX_SUCCESS))
+ goto fail;
+ }
+ rc = MDBX_RESULT_FALSE /* carry steady */;
+ }
+ } else {
+ rc = mdbx_filesync(env->me_fd,
+ (pending->mm_geo.next > recent_steady_meta->mm_geo.now)
+ ? MDBX_SYNC_DATA | MDBX_SYNC_SIZE
+ : MDBX_SYNC_DATA);
+ if (unlikely(rc != MDBX_SUCCESS))
+ goto fail;
+ }
+ }
+
+ /* Steady or Weak */
+ if (rc == MDBX_RESULT_FALSE /* carry steady */) {
+ pending->mm_datasync_sign = mdbx_meta_sign(pending);
+ *env->me_unsynced_pages = 0;
+ *env->me_sync_timestamp = mdbx_osal_monotime();
+ } else {
+ assert(rc == MDBX_RESULT_TRUE /* carry non-steady */);
+ pending->mm_datasync_sign = F_ISSET(env->me_flags, MDBX_UTTERLY_NOSYNC)
+ ? MDBX_DATASIGN_NONE
+ : MDBX_DATASIGN_WEAK;
+ }
+
+ MDBX_meta *target = nullptr;
+ if (mdbx_meta_txnid_stable(env, head) == pending->mm_txnid_a.inconsistent) {
+ mdbx_assert(env, memcmp(&head->mm_dbs, &pending->mm_dbs,
+ sizeof(head->mm_dbs)) == 0);
+ mdbx_assert(env, memcmp(&head->mm_canary, &pending->mm_canary,
+ sizeof(head->mm_canary)) == 0);
+ mdbx_assert(env, memcmp(&head->mm_geo, &pending->mm_geo,
+ sizeof(pending->mm_geo)) == 0);
+ if (!META_IS_STEADY(head) && META_IS_STEADY(pending))
+ target = head;
+ else {
+ mdbx_ensure(env, mdbx_meta_eq(env, head, pending));
+ mdbx_debug("%s", "skip update meta");
+ return MDBX_SUCCESS;
+ }
+ } else if (head == meta0)
+ target = mdbx_meta_ancient(prefer_steady, env, meta1, meta2);
+ else if (head == meta1)
+ target = mdbx_meta_ancient(prefer_steady, env, meta0, meta2);
+ else {
+ mdbx_assert(env, head == meta2);
+ target = mdbx_meta_ancient(prefer_steady, env, meta0, meta1);
+ }
+
+ /* LY: step#2 - update meta-page. */
+ mdbx_debug("writing meta%" PRIaPGNO " = root %" PRIaPGNO "/%" PRIaPGNO
+ ", geo %" PRIaPGNO "/%" PRIaPGNO "-%" PRIaPGNO "/%" PRIaPGNO
+ " +%u -%u, txn_id %" PRIaTXN ", %s",
+ data_page(target)->mp_pgno, pending->mm_dbs[MAIN_DBI].md_root,
+ pending->mm_dbs[FREE_DBI].md_root, pending->mm_geo.lower,
+ pending->mm_geo.next, pending->mm_geo.now, pending->mm_geo.upper,
+ pending->mm_geo.grow, pending->mm_geo.shrink,
+ pending->mm_txnid_a.inconsistent, mdbx_durable_str(pending));
+
+ mdbx_debug("meta0: %s, %s, txn_id %" PRIaTXN ", root %" PRIaPGNO
+ "/%" PRIaPGNO,
+ (meta0 == head) ? "head" : (meta0 == target) ? "tail" : "stay",
+ mdbx_durable_str(meta0), mdbx_meta_txnid_fluid(env, meta0),
+ meta0->mm_dbs[MAIN_DBI].md_root, meta0->mm_dbs[FREE_DBI].md_root);
+ mdbx_debug("meta1: %s, %s, txn_id %" PRIaTXN ", root %" PRIaPGNO
+ "/%" PRIaPGNO,
+ (meta1 == head) ? "head" : (meta1 == target) ? "tail" : "stay",
+ mdbx_durable_str(meta1), mdbx_meta_txnid_fluid(env, meta1),
+ meta1->mm_dbs[MAIN_DBI].md_root, meta1->mm_dbs[FREE_DBI].md_root);
+ mdbx_debug("meta2: %s, %s, txn_id %" PRIaTXN ", root %" PRIaPGNO
+ "/%" PRIaPGNO,
+ (meta2 == head) ? "head" : (meta2 == target) ? "tail" : "stay",
+ mdbx_durable_str(meta2), mdbx_meta_txnid_fluid(env, meta2),
+ meta2->mm_dbs[MAIN_DBI].md_root, meta2->mm_dbs[FREE_DBI].md_root);
+
+ mdbx_assert(env, !mdbx_meta_eq(env, pending, meta0));
+ mdbx_assert(env, !mdbx_meta_eq(env, pending, meta1));
+ mdbx_assert(env, !mdbx_meta_eq(env, pending, meta2));
+
+ mdbx_assert(env, ((env->me_flags ^ flags) & MDBX_WRITEMAP) == 0);
+ mdbx_ensure(env, target == head || mdbx_meta_txnid_stable(env, target) <
+ pending->mm_txnid_a.inconsistent);
+ if (env->me_flags & MDBX_WRITEMAP) {
+ mdbx_jitter4testing(true);
+ if (likely(target != head)) {
+ /* LY: 'invalidate' the meta. */
+ mdbx_meta_update_begin(env, target, pending->mm_txnid_a.inconsistent);
+ target->mm_datasync_sign = MDBX_DATASIGN_WEAK;
+#ifndef NDEBUG
+ /* debug: provoke failure to catch a violators, but don't touch mm_psize
+ * and mm_flags to allow readers catch actual pagesize. */
+ uint8_t *provoke_begin = (uint8_t *)&target->mm_dbs[FREE_DBI].md_root;
+ uint8_t *provoke_end = (uint8_t *)&target->mm_datasync_sign;
+ memset(provoke_begin, 0xCC, provoke_end - provoke_begin);
+ mdbx_jitter4testing(false);
+#endif
+
+ /* LY: update info */
+ target->mm_geo = pending->mm_geo;
+ target->mm_dbs[FREE_DBI] = pending->mm_dbs[FREE_DBI];
+ target->mm_dbs[MAIN_DBI] = pending->mm_dbs[MAIN_DBI];
+ target->mm_canary = pending->mm_canary;
+ target->mm_pages_retired = pending->mm_pages_retired;
+ mdbx_jitter4testing(true);
+ mdbx_flush_noncoherent_cpu_writeback();
+
+ /* LY: 'commit' the meta */
+ mdbx_meta_update_end(env, target, pending->mm_txnid_b.inconsistent);
+ mdbx_jitter4testing(true);
+ } else {
+ /* dangerous case (target == head), only mm_datasync_sign could
+ * me updated, check assertions once again */
+ mdbx_ensure(env, mdbx_meta_txnid_stable(env, head) ==
+ pending->mm_txnid_a.inconsistent &&
+ !META_IS_STEADY(head) && META_IS_STEADY(pending));
+ mdbx_ensure(env, memcmp(&head->mm_geo, &pending->mm_geo,
+ sizeof(head->mm_geo)) == 0);
+ mdbx_ensure(env, memcmp(&head->mm_dbs, &pending->mm_dbs,
+ sizeof(head->mm_dbs)) == 0);
+ mdbx_ensure(env, memcmp(&head->mm_canary, &pending->mm_canary,
+ sizeof(head->mm_canary)) == 0);
+ }
+ target->mm_datasync_sign = pending->mm_datasync_sign;
+ mdbx_flush_noncoherent_cpu_writeback();
+ mdbx_jitter4testing(true);
+ } else {
+ rc = mdbx_pwrite(env->me_fd, pending, sizeof(MDBX_meta),
+ (uint8_t *)target - env->me_map);
+ if (unlikely(rc != MDBX_SUCCESS)) {
+ undo:
+ mdbx_debug("%s", "write failed, disk error?");
+ /* On a failure, the pagecache still contains the new data.
+ * Try write some old data back, to prevent it from being used. */
+ mdbx_pwrite(env->me_fd, (void *)target, sizeof(MDBX_meta),
+ (uint8_t *)target - env->me_map);
+ goto fail;
+ }
+ mdbx_invalidate_mmap_noncoherent_cache(target, sizeof(MDBX_meta));
+ }
+
+ /* LY: step#3 - sync meta-pages. */
+ mdbx_assert(env, ((env->me_flags ^ flags) & MDBX_WRITEMAP) == 0);
+ if ((flags & (MDBX_NOSYNC | MDBX_NOMETASYNC)) == 0) {
+ mdbx_assert(env, ((flags ^ env->me_flags) & MDBX_WRITEMAP) == 0);
+ if (flags & MDBX_WRITEMAP) {
+ const size_t offset = (uint8_t *)data_page(head) - env->me_dxb_mmap.dxb;
+ const size_t paged_offset = offset & ~(env->me_os_psize - 1);
+ const size_t paged_length = roundup_powerof2(
+ env->me_psize + offset - paged_offset, env->me_os_psize);
+ rc = mdbx_msync(&env->me_dxb_mmap, paged_offset, paged_length,
+ flags & MDBX_MAPASYNC);
+ if (unlikely(rc != MDBX_SUCCESS))
+ goto fail;
+ } else {
+ rc = mdbx_filesync(env->me_fd, MDBX_SYNC_DATA | MDBX_SYNC_IODQ);
+ if (rc != MDBX_SUCCESS)
+ goto undo;
+ }
+ *env->me_meta_sync_txnid = (uint32_t)pending->mm_txnid_a.inconsistent;
+ }
+
+ /* LY: shrink datafile if needed */
+ if (unlikely(shrink)) {
+ mdbx_verbose("shrink to %" PRIaPGNO " pages (-%" PRIaPGNO ")",
+ pending->mm_geo.now, shrink);
+ rc = mdbx_mapresize(env, pending->mm_geo.now, pending->mm_geo.upper);
+ if (MDBX_IS_ERROR(rc))
+ goto fail;
+ }
+
+ return MDBX_SUCCESS;
+
+fail:
+ env->me_flags |= MDBX_FATAL_ERROR;
+ return rc;
+}
+
+int __cold mdbx_env_get_maxkeysize(MDBX_env *env) {
+ if (!env || env->me_signature != MDBX_ME_SIGNATURE || !env->me_maxkey_limit)
+ return (MDBX_EINVAL > 0) ? -MDBX_EINVAL : MDBX_EINVAL;
+ return env->me_maxkey_limit;
+}
+
+#define mdbx_nodemax(pagesize) \
+ (((((pagesize)-PAGEHDRSZ) / MDBX_MINKEYS) & ~(uintptr_t)1) - sizeof(indx_t))
+
+#define mdbx_maxkey(nodemax) ((nodemax)-NODESIZE - sizeof(MDBX_db))
+
+#define mdbx_maxgc_ov1page(pagesize) \
+ (((pagesize)-PAGEHDRSZ) / sizeof(pgno_t) - 1)
+
+static void __cold mdbx_setup_pagesize(MDBX_env *env, const size_t pagesize) {
+ STATIC_ASSERT(PTRDIFF_MAX > MAX_MAPSIZE);
+ STATIC_ASSERT(MIN_PAGESIZE > sizeof(MDBX_page) + sizeof(MDBX_meta));
+ mdbx_ensure(env, is_powerof2(pagesize));
+ mdbx_ensure(env, pagesize >= MIN_PAGESIZE);
+ mdbx_ensure(env, pagesize <= MAX_PAGESIZE);
+ env->me_psize = (unsigned)pagesize;
+
+ STATIC_ASSERT(mdbx_maxgc_ov1page(MIN_PAGESIZE) > 4);
+ STATIC_ASSERT(mdbx_maxgc_ov1page(MAX_PAGESIZE) < MDBX_DPL_TXNFULL);
+ const intptr_t maxgc_ov1page = (pagesize - PAGEHDRSZ) / sizeof(pgno_t) - 1;
+ mdbx_ensure(env,
+ maxgc_ov1page > 42 && maxgc_ov1page < (intptr_t)MDBX_DPL_TXNFULL);
+ env->me_maxgc_ov1page = (unsigned)maxgc_ov1page;
+
+ STATIC_ASSERT(mdbx_nodemax(MIN_PAGESIZE) > 42);
+ STATIC_ASSERT(mdbx_nodemax(MAX_PAGESIZE) < UINT16_MAX);
+ const intptr_t nodemax = mdbx_nodemax(pagesize);
+ mdbx_ensure(env, nodemax > 42 && nodemax < UINT16_MAX && nodemax % 2 == 0);
+ env->me_nodemax = (unsigned)nodemax;
+
+ STATIC_ASSERT(mdbx_maxkey(MIN_PAGESIZE) > 42);
+ STATIC_ASSERT(mdbx_maxkey(MIN_PAGESIZE) < MIN_PAGESIZE);
+ STATIC_ASSERT(mdbx_maxkey(MAX_PAGESIZE) > 42);
+ STATIC_ASSERT(mdbx_maxkey(MAX_PAGESIZE) < MAX_PAGESIZE);
+ const intptr_t maxkey_limit = mdbx_maxkey(env->me_nodemax);
+ mdbx_ensure(env, maxkey_limit > 42 && (size_t)maxkey_limit < pagesize &&
+ maxkey_limit % 2 == 0);
+ env->me_maxkey_limit = (unsigned)maxkey_limit;
+
+ env->me_psize2log = log2n(pagesize);
+ mdbx_assert(env, pgno2bytes(env, 1) == pagesize);
+ mdbx_assert(env, bytes2pgno(env, pagesize + pagesize) == 2);
+}
+
+int __cold mdbx_env_create(MDBX_env **penv) {
+ MDBX_env *env = mdbx_calloc(1, sizeof(MDBX_env));
+ if (unlikely(!env))
+ return MDBX_ENOMEM;
+
+ env->me_maxreaders = DEFAULT_READERS;
+ env->me_maxdbs = env->me_numdbs = CORE_DBS;
+ env->me_fd = INVALID_HANDLE_VALUE;
+ env->me_lfd = INVALID_HANDLE_VALUE;
+ env->me_pid = mdbx_getpid();
+
+ int rc;
+ const size_t os_psize = mdbx_syspagesize();
+ if (unlikely(!is_powerof2(os_psize) || os_psize < MIN_PAGESIZE)) {
+ mdbx_error("unsuitable system pagesize %" PRIuPTR, os_psize);
+ rc = MDBX_INCOMPATIBLE;
+ goto bailout;
+ }
+ env->me_os_psize = (unsigned)os_psize;
+ mdbx_setup_pagesize(env, env->me_os_psize);
+
+ rc = mdbx_fastmutex_init(&env->me_dbi_lock);
+ if (unlikely(rc != MDBX_SUCCESS))
+ goto bailout;
+
+#if defined(_WIN32) || defined(_WIN64)
+ mdbx_srwlock_Init(&env->me_remap_guard);
+ InitializeCriticalSection(&env->me_windowsbug_lock);
+#else
+ rc = mdbx_fastmutex_init(&env->me_remap_guard);
+ if (unlikely(rc != MDBX_SUCCESS)) {
+ mdbx_fastmutex_destroy(&env->me_dbi_lock);
+ goto bailout;
+ }
+ rc = mdbx_fastmutex_init(&env->me_lckless_stub.wmutex);
+ if (unlikely(rc != MDBX_SUCCESS)) {
+ mdbx_fastmutex_destroy(&env->me_remap_guard);
+ mdbx_fastmutex_destroy(&env->me_dbi_lock);
+ goto bailout;
+ }
+#endif /* Windows */
+
+ VALGRIND_CREATE_MEMPOOL(env, 0, 0);
+ env->me_signature = MDBX_ME_SIGNATURE;
+ *penv = env;
+ return MDBX_SUCCESS;
+
+bailout:
+ mdbx_free(env);
+ *penv = nullptr;
+ return rc;
+}
+
+__cold LIBMDBX_API int
+mdbx_env_set_geometry(MDBX_env *env, intptr_t size_lower, intptr_t size_now,
+ intptr_t size_upper, intptr_t growth_step,
+ intptr_t shrink_threshold, intptr_t pagesize) {
+ if (unlikely(!env))
+ return MDBX_EINVAL;
+
+ if (unlikely(env->me_signature != MDBX_ME_SIGNATURE))
+ return MDBX_EBADSIGN;
+
+#if MDBX_TXN_CHECKPID
+ if (unlikely(env->me_pid != mdbx_getpid()))
+ env->me_flags |= MDBX_FATAL_ERROR;
+#endif /* MDBX_TXN_CHECKPID */
+
+ if (unlikely(env->me_flags & MDBX_FATAL_ERROR))
+ return MDBX_PANIC;
+
+ const bool inside_txn =
+ (env->me_txn0 && env->me_txn0->mt_owner == mdbx_thread_self());
+
+#if MDBX_DEBUG
+ if (growth_step < 0)
+ growth_step = 1;
+ if (shrink_threshold < 0)
+ shrink_threshold = 1;
+#endif
+
+ bool need_unlock = false;
+ int rc = MDBX_PROBLEM;
+ if (env->me_map) {
+ /* env already mapped */
+ if (unlikely(env->me_flags & MDBX_RDONLY))
+ return MDBX_EACCESS;
+
+ if (!inside_txn) {
+ int err = mdbx_txn_lock(env, false);
+ if (unlikely(err != MDBX_SUCCESS))
+ return err;
+ need_unlock = true;
+ }
+ MDBX_meta *head = mdbx_meta_head(env);
+ if (!inside_txn) {
+ env->me_txn0->mt_txnid = meta_txnid(env, head, false);
+ mdbx_find_oldest(env->me_txn0);
+ }
+
+ /* get untouched params from DB */
+ if (pagesize < 0)
+ pagesize = env->me_psize;
+ if (size_lower < 0)
+ size_lower = pgno2bytes(env, head->mm_geo.lower);
+ if (size_now < 0)
+ size_now = pgno2bytes(env, head->mm_geo.now);
+ if (size_upper < 0)
+ size_upper = pgno2bytes(env, head->mm_geo.upper);
+ if (growth_step < 0)
+ growth_step = pgno2bytes(env, head->mm_geo.grow);
+ if (shrink_threshold < 0)
+ shrink_threshold = pgno2bytes(env, head->mm_geo.shrink);
+
+ if (pagesize != (intptr_t)env->me_psize) {
+ rc = MDBX_EINVAL;
+ goto bailout;
+ }
+ const size_t usedbytes =
+ pgno2bytes(env, mdbx_find_largest(env, head->mm_geo.next));
+ if ((size_t)size_upper < usedbytes) {
+ rc = MDBX_MAP_FULL;
+ goto bailout;
+ }
+ if ((size_t)size_now < usedbytes)
+ size_now = usedbytes;
+ } else {
+ /* env NOT yet mapped */
+ if (unlikely(inside_txn))
+ return MDBX_PANIC;
+
+ if (pagesize < 0) {
+ pagesize = env->me_os_psize;
+ if ((uintptr_t)pagesize > MAX_PAGESIZE)
+ pagesize = MAX_PAGESIZE;
+ mdbx_assert(env, (uintptr_t)pagesize >= MIN_PAGESIZE);
+ }
+ }
+
+ if (pagesize == 0)
+ pagesize = MIN_PAGESIZE;
+ else if (pagesize == INTPTR_MAX)
+ pagesize = MAX_PAGESIZE;
+
+ if (pagesize < (intptr_t)MIN_PAGESIZE || pagesize > (intptr_t)MAX_PAGESIZE ||
+ !is_powerof2(pagesize)) {
+ rc = MDBX_EINVAL;
+ goto bailout;
+ }
+
+ if (size_lower <= 0) {
+ size_lower = MIN_MAPSIZE;
+ if (MIN_MAPSIZE / pagesize < MIN_PAGENO)
+ size_lower = MIN_PAGENO * pagesize;
+ }
+
+ if (size_now <= 0) {
+ size_now = DEFAULT_MAPSIZE;
+ if (size_now < size_lower)
+ size_now = size_lower;
+ if (size_upper >= size_lower && size_now > size_upper)
+ size_now = size_upper;
+ }
+
+ if (size_upper <= 0) {
+ if ((size_t)size_now >= MAX_MAPSIZE / 2)
+ size_upper = MAX_MAPSIZE;
+ else if (MAX_MAPSIZE != MAX_MAPSIZE32 &&
+ (size_t)size_now >= MAX_MAPSIZE32 / 2 &&
+ (size_t)size_now <= MAX_MAPSIZE32 / 4 * 3)
+ size_upper = MAX_MAPSIZE32;
+ else {
+ size_upper = size_now + size_now;
+ if ((size_t)size_upper < DEFAULT_MAPSIZE * 2)
+ size_upper = DEFAULT_MAPSIZE * 2;
+ }
+ if ((size_t)size_upper / pagesize > MAX_PAGENO)
+ size_upper = pagesize * MAX_PAGENO;
+ }
+
+ if (unlikely(size_lower < (intptr_t)MIN_MAPSIZE || size_lower > size_upper)) {
+ rc = MDBX_EINVAL;
+ goto bailout;
+ }
+
+ if ((uint64_t)size_lower / pagesize < MIN_PAGENO) {
+ rc = MDBX_EINVAL;
+ goto bailout;
+ }
+
+ if (unlikely((size_t)size_upper > MAX_MAPSIZE ||
+ (uint64_t)size_upper / pagesize > MAX_PAGENO)) {
+ rc = MDBX_TOO_LARGE;
+ goto bailout;
+ }
+
+ size_lower = roundup_powerof2(size_lower, env->me_os_psize);
+ size_upper = roundup_powerof2(size_upper, env->me_os_psize);
+ size_now = roundup_powerof2(size_now, env->me_os_psize);
+
+ /* LY: подбираем значение size_upper:
+ * - кратное размеру системной страницы
+ * - без нарушения MAX_MAPSIZE и MAX_PAGENO */
+ while (unlikely((size_t)size_upper > MAX_MAPSIZE ||
+ (uint64_t)size_upper / pagesize > MAX_PAGENO)) {
+ if ((size_t)size_upper < env->me_os_psize + MIN_MAPSIZE ||
+ (size_t)size_upper < env->me_os_psize * (MIN_PAGENO + 1)) {
+ /* паранойа на случай переполнения при невероятных значениях */
+ rc = MDBX_EINVAL;
+ goto bailout;
+ }
+ size_upper -= env->me_os_psize;
+ if ((size_t)size_upper < (size_t)size_lower)
+ size_lower = size_upper;
+ }
+ mdbx_assert(env, (size_upper - size_lower) % env->me_os_psize == 0);
+
+ if (size_now < size_lower)
+ size_now = size_lower;
+ if (size_now > size_upper)
+ size_now = size_upper;
+
+ if (growth_step < 0) {
+ growth_step = ((size_t)(size_upper - size_lower)) / 42;
+ if (growth_step > size_lower)
+ growth_step = size_lower;
+ if (growth_step < 65536)
+ growth_step = 65536;
+ if ((size_t)growth_step > MEGABYTE * 16)
+ growth_step = MEGABYTE * 16;
+ }
+ if (growth_step == 0 && shrink_threshold > 0)
+ growth_step = 1;
+ growth_step = roundup_powerof2(growth_step, env->me_os_psize);
+ if (bytes2pgno(env, growth_step) > UINT16_MAX)
+ growth_step = pgno2bytes(env, UINT16_MAX);
+
+ if (shrink_threshold < 0)
+ shrink_threshold = growth_step + growth_step;
+ shrink_threshold = roundup_powerof2(shrink_threshold, env->me_os_psize);
+ if (bytes2pgno(env, shrink_threshold) > UINT16_MAX)
+ shrink_threshold = pgno2bytes(env, UINT16_MAX);
+
+ /* save user's geo-params for future open/create */
+ env->me_dbgeo.lower = size_lower;
+ env->me_dbgeo.now = size_now;
+ env->me_dbgeo.upper = size_upper;
+ env->me_dbgeo.grow = growth_step;
+ env->me_dbgeo.shrink = shrink_threshold;
+ rc = MDBX_SUCCESS;
+
+ mdbx_ensure(env, pagesize >= MIN_PAGESIZE);
+ mdbx_ensure(env, pagesize <= MAX_PAGESIZE);
+ mdbx_ensure(env, is_powerof2(pagesize));
+ mdbx_ensure(env, is_powerof2(env->me_os_psize));
+
+ mdbx_ensure(env, env->me_dbgeo.lower >= MIN_MAPSIZE);
+ mdbx_ensure(env, env->me_dbgeo.lower / pagesize >= MIN_PAGENO);
+ mdbx_ensure(env, env->me_dbgeo.lower % pagesize == 0);
+ mdbx_ensure(env, env->me_dbgeo.lower % env->me_os_psize == 0);
+
+ mdbx_ensure(env, env->me_dbgeo.upper <= MAX_MAPSIZE);
+ mdbx_ensure(env, env->me_dbgeo.upper / pagesize <= MAX_PAGENO);
+ mdbx_ensure(env, env->me_dbgeo.upper % pagesize == 0);
+ mdbx_ensure(env, env->me_dbgeo.upper % env->me_os_psize == 0);
+
+ mdbx_ensure(env, env->me_dbgeo.now >= env->me_dbgeo.lower);
+ mdbx_ensure(env, env->me_dbgeo.now <= env->me_dbgeo.upper);
+ mdbx_ensure(env, env->me_dbgeo.now % pagesize == 0);
+ mdbx_ensure(env, env->me_dbgeo.now % env->me_os_psize == 0);
+
+ mdbx_ensure(env, env->me_dbgeo.grow % pagesize == 0);
+ mdbx_ensure(env, env->me_dbgeo.grow % env->me_os_psize == 0);
+ mdbx_ensure(env, env->me_dbgeo.shrink % pagesize == 0);
+ mdbx_ensure(env, env->me_dbgeo.shrink % env->me_os_psize == 0);
+
+ if (env->me_map) {
+ /* apply new params to opened environment */
+ mdbx_ensure(env, pagesize == (intptr_t)env->me_psize);
+ MDBX_meta meta;
+ MDBX_meta *head = nullptr;
+ const mdbx_geo_t *current_geo;
+ if (inside_txn) {
+ current_geo = &env->me_txn->mt_geo;
+ } else {
+ head = mdbx_meta_head(env);
+ meta = *head;
+ current_geo = &meta.mm_geo;
+ }
+
+ mdbx_geo_t new_geo;
+ new_geo.lower = bytes2pgno(env, env->me_dbgeo.lower);
+ new_geo.now = bytes2pgno(env, env->me_dbgeo.now);
+ new_geo.upper = bytes2pgno(env, env->me_dbgeo.upper);
+ new_geo.grow = (uint16_t)bytes2pgno(env, env->me_dbgeo.grow);
+ new_geo.shrink = (uint16_t)bytes2pgno(env, env->me_dbgeo.shrink);
+ new_geo.next = current_geo->next;
+
+ mdbx_ensure(env,
+ pgno_align2os_bytes(env, new_geo.lower) == env->me_dbgeo.lower);
+ mdbx_ensure(env,
+ pgno_align2os_bytes(env, new_geo.upper) == env->me_dbgeo.upper);
+ mdbx_ensure(env,
+ pgno_align2os_bytes(env, new_geo.now) == env->me_dbgeo.now);
+ mdbx_ensure(env,
+ pgno_align2os_bytes(env, new_geo.grow) == env->me_dbgeo.grow);
+ mdbx_ensure(env, pgno_align2os_bytes(env, new_geo.shrink) ==
+ env->me_dbgeo.shrink);
+
+ mdbx_ensure(env, env->me_dbgeo.lower >= MIN_MAPSIZE);
+ mdbx_ensure(env, new_geo.lower >= MIN_PAGENO);
+ mdbx_ensure(env, env->me_dbgeo.upper <= MAX_MAPSIZE);
+ mdbx_ensure(env, new_geo.upper <= MAX_PAGENO);
+ mdbx_ensure(env, new_geo.now >= new_geo.next);
+ mdbx_ensure(env, new_geo.upper >= new_geo.now);
+ mdbx_ensure(env, new_geo.now >= new_geo.lower);
+
+ if (memcmp(current_geo, &new_geo, sizeof(mdbx_geo_t)) != 0) {
+#if defined(_WIN32) || defined(_WIN64)
+ /* Was DB shrinking disabled before and now it will be enabled? */
+ if (new_geo.lower < new_geo.upper && new_geo.shrink &&
+ !(current_geo->lower < current_geo->upper && current_geo->shrink)) {
+ if (!env->me_lck) {
+ rc = MDBX_EPERM;
+ goto bailout;
+ }
+ rc = mdbx_rdt_lock(env);
+ if (unlikely(rc != MDBX_SUCCESS))
+ goto bailout;
+
+ /* Check if there are any reading threads that do not use the SRWL */
+ const size_t CurrentTid = GetCurrentThreadId();
+ const MDBX_reader *const begin = env->me_lck->mti_readers;
+ const MDBX_reader *const end = begin + env->me_lck->mti_numreaders;
+ for (const MDBX_reader *reader = begin; reader < end; ++reader) {
+ if (reader->mr_pid == env->me_pid && reader->mr_tid &&
+ reader->mr_tid != CurrentTid) {
+ /* At least one thread may don't use SRWL */
+ rc = MDBX_EPERM;
+ break;
+ }
+ }
+
+ mdbx_rdt_unlock(env);
+ if (unlikely(rc != MDBX_SUCCESS))
+ goto bailout;
+ }
+#endif
+
+ if (new_geo.now != current_geo->now ||
+ new_geo.upper != current_geo->upper) {
+ rc = mdbx_mapresize(env, new_geo.now, new_geo.upper);
+ if (unlikely(rc != MDBX_SUCCESS))
+ goto bailout;
+ mdbx_assert(env, (head == nullptr) == inside_txn);
+ if (head)
+ head = /* base address could be changed */ mdbx_meta_head(env);
+ }
+ if (inside_txn) {
+ env->me_txn->mt_geo = new_geo;
+ if ((env->me_txn->mt_flags & MDBX_TXN_DIRTY) == 0) {
+ env->me_txn->mt_flags |= MDBX_TXN_DIRTY;
+ *env->me_unsynced_pages += 1;
+ }
+ } else {
+ *env->me_unsynced_pages += 1;
+ mdbx_meta_set_txnid(
+ env, &meta, safe64_txnid_next(mdbx_meta_txnid_stable(env, head)));
+ rc = mdbx_sync_locked(env, env->me_flags, &meta);
+ }
+ }
+ } else if (pagesize != (intptr_t)env->me_psize) {
+ mdbx_setup_pagesize(env, pagesize);
+ }
+
+bailout:
+ if (need_unlock)
+ mdbx_txn_unlock(env);
+ return rc;
+}
+
+int __cold mdbx_env_set_mapsize(MDBX_env *env, size_t size) {
+ return mdbx_env_set_geometry(env, size, size, size, -1, -1, -1);
+}
+
+int __cold mdbx_env_set_maxdbs(MDBX_env *env, MDBX_dbi dbs) {
+ if (unlikely(dbs > MAX_DBI))
+ return MDBX_EINVAL;
+
+ if (unlikely(!env))
+ return MDBX_EINVAL;
+
+ if (unlikely(env->me_signature != MDBX_ME_SIGNATURE))
+ return MDBX_EBADSIGN;
+
+ if (unlikely(env->me_map))
+ return MDBX_EPERM;
+
+ env->me_maxdbs = dbs + CORE_DBS;
+ return MDBX_SUCCESS;
+}
+
+int __cold mdbx_env_set_maxreaders(MDBX_env *env, unsigned readers) {
+ if (unlikely(readers < 1 || readers > MDBX_READERS_LIMIT))
+ return MDBX_EINVAL;
+
+ if (unlikely(!env))
+ return MDBX_EINVAL;
+
+ if (unlikely(env->me_signature != MDBX_ME_SIGNATURE))
+ return MDBX_EBADSIGN;
+
+ if (unlikely(env->me_map))
+ return MDBX_EPERM;
+
+ env->me_maxreaders = readers;
+ return MDBX_SUCCESS;
+}
+
+int __cold mdbx_env_get_maxreaders(MDBX_env *env, unsigned *readers) {
+ if (!env || !readers)
+ return MDBX_EINVAL;
+
+ if (unlikely(env->me_signature != MDBX_ME_SIGNATURE))
+ return MDBX_EBADSIGN;
+
+ *readers = env->me_maxreaders;
+ return MDBX_SUCCESS;
+}
+
+/* Further setup required for opening an MDBX environment */
+static int __cold mdbx_setup_dxb(MDBX_env *env, const int lck_rc) {
+ uint64_t filesize_before;
+ MDBX_meta meta;
+ int rc = MDBX_RESULT_FALSE;
+ int err = mdbx_read_header(env, &meta, &filesize_before);
+ if (unlikely(err != MDBX_SUCCESS)) {
+ if (lck_rc != /* lck exclusive */ MDBX_RESULT_TRUE || err != MDBX_ENODATA ||
+ (env->me_flags & MDBX_RDONLY) != 0)
+ return err;
+
+ mdbx_debug("%s", "create new database");
+ rc = /* new database */ MDBX_RESULT_TRUE;
+
+ if (!env->me_dbgeo.now) {
+ /* set defaults if not configured */
+ err = mdbx_env_set_mapsize(env, DEFAULT_MAPSIZE);
+ if (unlikely(err != MDBX_SUCCESS))
+ return err;
+ }
+
+ void *buffer = mdbx_calloc(NUM_METAS, env->me_psize);
+ if (!buffer)
+ return MDBX_ENOMEM;
+
+ meta = *mdbx_init_metas(env, buffer);
+ err = mdbx_pwrite(env->me_fd, buffer, env->me_psize * NUM_METAS, 0);
+ mdbx_free(buffer);
+ if (unlikely(err != MDBX_SUCCESS))
+ return err;
+
+ err = mdbx_ftruncate(env->me_fd, filesize_before = env->me_dbgeo.now);
+ if (unlikely(err != MDBX_SUCCESS))
+ return err;
+
+#ifndef NDEBUG /* just for checking */
+ err = mdbx_read_header(env, &meta, &filesize_before);
+ if (unlikely(err != MDBX_SUCCESS))
+ return err;
+#endif
+ }
+
+ mdbx_verbose("header: root %" PRIaPGNO "/%" PRIaPGNO ", geo %" PRIaPGNO
+ "/%" PRIaPGNO "-%" PRIaPGNO "/%" PRIaPGNO
+ " +%u -%u, txn_id %" PRIaTXN ", %s",
+ meta.mm_dbs[MAIN_DBI].md_root, meta.mm_dbs[FREE_DBI].md_root,
+ meta.mm_geo.lower, meta.mm_geo.next, meta.mm_geo.now,
+ meta.mm_geo.upper, meta.mm_geo.grow, meta.mm_geo.shrink,
+ meta.mm_txnid_a.inconsistent, mdbx_durable_str(&meta));
+
+ mdbx_setup_pagesize(env, meta.mm_psize);
+ const size_t used_bytes = pgno2bytes(env, meta.mm_geo.next);
+ const size_t used_aligned2os_bytes =
+ roundup_powerof2(used_bytes, env->me_os_psize);
+ if ((env->me_flags & MDBX_RDONLY) /* readonly */
+ || lck_rc != MDBX_RESULT_TRUE /* not exclusive */) {
+ /* use present params from db */
+ const size_t pagesize = meta.mm_psize;
+ err = mdbx_env_set_geometry(
+ env, meta.mm_geo.lower * pagesize, meta.mm_geo.now * pagesize,
+ meta.mm_geo.upper * pagesize, meta.mm_geo.grow * pagesize,
+ meta.mm_geo.shrink * pagesize, meta.mm_psize);
+ if (unlikely(err != MDBX_SUCCESS)) {
+ mdbx_error("%s", "could not use present dbsize-params from db");
+ return MDBX_INCOMPATIBLE;
+ }
+ } else if (env->me_dbgeo.now) {
+ /* silently growth to last used page */
+ if (env->me_dbgeo.now < used_aligned2os_bytes)
+ env->me_dbgeo.now = used_aligned2os_bytes;
+ if (env->me_dbgeo.upper < used_aligned2os_bytes)
+ env->me_dbgeo.upper = used_aligned2os_bytes;
+
+ /* apply preconfigured params, but only if substantial changes:
+ * - upper or lower limit changes
+ * - shrink threshold or growth step
+ * But ignore change just a 'now/current' size. */
+ if (bytes_align2os_bytes(env, env->me_dbgeo.upper) !=
+ pgno2bytes(env, meta.mm_geo.upper) ||
+ bytes_align2os_bytes(env, env->me_dbgeo.lower) !=
+ pgno2bytes(env, meta.mm_geo.lower) ||
+ bytes_align2os_bytes(env, env->me_dbgeo.shrink) !=
+ pgno2bytes(env, meta.mm_geo.shrink) ||
+ bytes_align2os_bytes(env, env->me_dbgeo.grow) !=
+ pgno2bytes(env, meta.mm_geo.grow)) {
+
+ if (env->me_dbgeo.shrink && env->me_dbgeo.now > used_bytes)
+ /* pre-shrink if enabled */
+ env->me_dbgeo.now = used_bytes + env->me_dbgeo.shrink -
+ used_bytes % env->me_dbgeo.shrink;
+
+ err = mdbx_env_set_geometry(env, env->me_dbgeo.lower, env->me_dbgeo.now,
+ env->me_dbgeo.upper, env->me_dbgeo.grow,
+ env->me_dbgeo.shrink, meta.mm_psize);
+ if (unlikely(err != MDBX_SUCCESS)) {
+ mdbx_error("%s", "could not apply preconfigured dbsize-params to db");
+ return MDBX_INCOMPATIBLE;
+ }
+
+ /* update meta fields */
+ meta.mm_geo.now = bytes2pgno(env, env->me_dbgeo.now);
+ meta.mm_geo.lower = bytes2pgno(env, env->me_dbgeo.lower);
+ meta.mm_geo.upper = bytes2pgno(env, env->me_dbgeo.upper);
+ meta.mm_geo.grow = (uint16_t)bytes2pgno(env, env->me_dbgeo.grow);
+ meta.mm_geo.shrink = (uint16_t)bytes2pgno(env, env->me_dbgeo.shrink);
+
+ mdbx_verbose("amended: root %" PRIaPGNO "/%" PRIaPGNO ", geo %" PRIaPGNO
+ "/%" PRIaPGNO "-%" PRIaPGNO "/%" PRIaPGNO
+ " +%u -%u, txn_id %" PRIaTXN ", %s",
+ meta.mm_dbs[MAIN_DBI].md_root, meta.mm_dbs[FREE_DBI].md_root,
+ meta.mm_geo.lower, meta.mm_geo.next, meta.mm_geo.now,
+ meta.mm_geo.upper, meta.mm_geo.grow, meta.mm_geo.shrink,
+ meta.mm_txnid_a.inconsistent, mdbx_durable_str(&meta));
+ } else {
+ /* fetch back 'now/current' size, since it was ignored during comparison
+ * and may differ. */
+ env->me_dbgeo.now = pgno_align2os_bytes(env, meta.mm_geo.now);
+ }
+ mdbx_ensure(env, meta.mm_geo.now >= meta.mm_geo.next);
+ } else {
+ /* geo-params are not pre-configured by user,
+ * get current values from the meta. */
+ env->me_dbgeo.now = pgno2bytes(env, meta.mm_geo.now);
+ env->me_dbgeo.lower = pgno2bytes(env, meta.mm_geo.lower);
+ env->me_dbgeo.upper = pgno2bytes(env, meta.mm_geo.upper);
+ env->me_dbgeo.grow = pgno2bytes(env, meta.mm_geo.grow);
+ env->me_dbgeo.shrink = pgno2bytes(env, meta.mm_geo.shrink);
+ }
+
+ mdbx_ensure(env,
+ pgno_align2os_bytes(env, meta.mm_geo.now) == env->me_dbgeo.now);
+ mdbx_ensure(env, env->me_dbgeo.now >= used_bytes);
+ if (unlikely(filesize_before != env->me_dbgeo.now)) {
+ if (lck_rc != /* lck exclusive */ MDBX_RESULT_TRUE) {
+ mdbx_verbose("filesize mismatch (expect %" PRIuPTR "b/%" PRIaPGNO
+ "p, have %" PRIu64 "b/%" PRIaPGNO "p), "
+ "assume other process working",
+ env->me_dbgeo.now, bytes2pgno(env, env->me_dbgeo.now),
+ filesize_before, bytes2pgno(env, (size_t)filesize_before));
+ } else {
+ mdbx_notice("filesize mismatch (expect %" PRIuSIZE "b/%" PRIaPGNO
+ "p, have %" PRIu64 "b/%" PRIaPGNO "p)",
+ env->me_dbgeo.now, bytes2pgno(env, env->me_dbgeo.now),
+ filesize_before, bytes2pgno(env, (size_t)filesize_before));
+ if (filesize_before < used_bytes) {
+ mdbx_error("last-page beyond end-of-file (last %" PRIaPGNO
+ ", have %" PRIaPGNO ")",
+ meta.mm_geo.next, bytes2pgno(env, (size_t)filesize_before));
+ return MDBX_CORRUPTED;
+ }
+
+ if (env->me_flags & MDBX_RDONLY) {
+ if (filesize_before & (env->me_os_psize - 1)) {
+ mdbx_error("%s", "filesize should be rounded-up to system page");
+ return MDBX_WANNA_RECOVERY;
+ }
+ mdbx_warning("%s", "ignore filesize mismatch in readonly-mode");
+ } else {
+ mdbx_verbose("will resize datafile to %" PRIuSIZE " bytes, %" PRIaPGNO
+ " pages",
+ env->me_dbgeo.now, bytes2pgno(env, env->me_dbgeo.now));
+ }
+ }
+ }
+
+ err = mdbx_mmap(env->me_flags, &env->me_dxb_mmap, env->me_dbgeo.now,
+ env->me_dbgeo.upper, lck_rc);
+ if (unlikely(err != MDBX_SUCCESS))
+ return err;
+
+#if defined(MADV_DODUMP) && defined(MADV_DONTDUMP)
+ const size_t meta_length = pgno2bytes(env, NUM_METAS);
+ (void)madvise(env->me_map, meta_length, MADV_DODUMP);
+ (void)madvise(env->me_map + meta_length, env->me_dxb_mmap.limit - meta_length,
+ (mdbx_runtime_flags & MDBX_DBG_DUMP) ? MADV_DODUMP
+ : MADV_DONTDUMP);
+#endif
+
+ *env->me_discarded_tail = bytes2pgno(env, used_aligned2os_bytes);
+ if (used_aligned2os_bytes < env->me_dxb_mmap.current) {
+#if defined(MADV_REMOVE)
+ if (lck_rc && (env->me_flags & MDBX_WRITEMAP) != 0) {
+ mdbx_notice("open-MADV_%s %u..%u", "REMOVE", *env->me_discarded_tail,
+ bytes2pgno(env, env->me_dxb_mmap.current));
+ (void)madvise(env->me_map + used_aligned2os_bytes,
+ env->me_dxb_mmap.current - used_aligned2os_bytes,
+ MADV_REMOVE);
+ }
+#endif /* MADV_REMOVE */
+#if defined(MADV_DONTNEED)
+ mdbx_notice("open-MADV_%s %u..%u", "DONTNEED", *env->me_discarded_tail,
+ bytes2pgno(env, env->me_dxb_mmap.current));
+ (void)madvise(env->me_map + used_aligned2os_bytes,
+ env->me_dxb_mmap.current - used_aligned2os_bytes,
+ MADV_DONTNEED);
+#elif defined(POSIX_MADV_DONTNEED)
+ (void)madvise(env->me_map + used_aligned2os_bytes,
+ env->me_dxb_mmap.current - used_aligned2os_bytes,
+ POSIX_MADV_DONTNEED);
+#elif defined(POSIX_FADV_DONTNEED)
+ (void)posix_fadvise(env->me_fd, used_aligned2os_bytes,
+ env->me_dxb_mmap.current - used_aligned2os_bytes,
+ POSIX_FADV_DONTNEED);
+#endif /* MADV_DONTNEED */
+ }
+
+#ifdef MDBX_USE_VALGRIND
+ env->me_valgrind_handle =
+ VALGRIND_CREATE_BLOCK(env->me_map, env->me_dxb_mmap.limit, "mdbx");
+#endif
+
+ const bool readahead = (env->me_flags & MDBX_NORDAHEAD) == 0 &&
+ mdbx_is_readahead_reasonable(env->me_dxb_mmap.current,
+ 0) == MDBX_RESULT_TRUE;
+ err = mdbx_set_readahead(env, 0, env->me_dxb_mmap.current, readahead);
+ if (err != MDBX_SUCCESS)
+ return err;
+
+ mdbx_assert(env, used_bytes >= pgno2bytes(env, NUM_METAS) &&
+ used_bytes <= env->me_dxb_mmap.limit);
+#if defined(MDBX_USE_VALGRIND) || defined(__SANITIZE_ADDRESS__)
+ VALGRIND_MAKE_MEM_NOACCESS(env->me_map + used_bytes,
+ env->me_dxb_mmap.limit - used_bytes);
+ ASAN_POISON_MEMORY_REGION(env->me_map + used_bytes,
+ env->me_dxb_mmap.limit - used_bytes);
+ env->me_poison_edge = bytes2pgno(env, env->me_dxb_mmap.limit);
+#endif /* MDBX_USE_VALGRIND */
+
+ /* NOTE: AddressSanitizer (at least GCC 7.x, 8.x) could generate
+ * false-positive alarm here. I have no other explanation for this
+ * except due to an internal ASAN error, as the problem is reproduced
+ * in a single-threaded application under the active assert() above. */
+ const unsigned meta_clash_mask = mdbx_meta_eq_mask(env);
+ if (meta_clash_mask) {
+ mdbx_error("meta-pages are clashed: mask 0x%d", meta_clash_mask);
+ return MDBX_WANNA_RECOVERY;
+ }
+
+ while (1) {
+ MDBX_meta *head = mdbx_meta_head(env);
+ const txnid_t head_txnid = mdbx_meta_txnid_fluid(env, head);
+ if (head_txnid == meta.mm_txnid_a.inconsistent)
+ break;
+
+ if (lck_rc == /* lck exclusive */ MDBX_RESULT_TRUE) {
+ mdbx_assert(env, META_IS_STEADY(&meta) && !META_IS_STEADY(head));
+ if (env->me_flags & MDBX_RDONLY) {
+ mdbx_error("rollback needed: (from head %" PRIaTXN
+ " to steady %" PRIaTXN "), but unable in read-only mode",
+ head_txnid, meta.mm_txnid_a.inconsistent);
+ return MDBX_WANNA_RECOVERY /* LY: could not recovery/rollback */;
+ }
+
+ const MDBX_meta *const meta0 = METAPAGE(env, 0);
+ const MDBX_meta *const meta1 = METAPAGE(env, 1);
+ const MDBX_meta *const meta2 = METAPAGE(env, 2);
+ txnid_t undo_txnid = 0 /* zero means undo is unneeded */;
+ while (
+ (head != meta0 && mdbx_meta_txnid_fluid(env, meta0) == undo_txnid) ||
+ (head != meta1 && mdbx_meta_txnid_fluid(env, meta1) == undo_txnid) ||
+ (head != meta2 && mdbx_meta_txnid_fluid(env, meta2) == undo_txnid))
+ undo_txnid = safe64_txnid_next(undo_txnid);
+ if (unlikely(undo_txnid >= meta.mm_txnid_a.inconsistent)) {
+ mdbx_fatal("rollback failed: no suitable txnid (0,1,2) < %" PRIaTXN,
+ meta.mm_txnid_a.inconsistent);
+ return MDBX_PANIC /* LY: could not recovery/rollback */;
+ }
+
+ /* LY: rollback weak checkpoint */
+ mdbx_trace("rollback: from %" PRIaTXN ", to %" PRIaTXN " as %" PRIaTXN,
+ head_txnid, meta.mm_txnid_a.inconsistent, undo_txnid);
+ mdbx_ensure(env, head_txnid == mdbx_meta_txnid_stable(env, head));
+
+ if (env->me_flags & MDBX_WRITEMAP) {
+ /* It is possible to update txnid without safe64_write(),
+ * since DB opened exclusive for now */
+ head->mm_txnid_a.inconsistent = undo_txnid;
+ head->mm_datasync_sign = MDBX_DATASIGN_WEAK;
+ head->mm_txnid_b.inconsistent = undo_txnid;
+ const size_t offset = (uint8_t *)data_page(head) - env->me_dxb_mmap.dxb;
+ const size_t paged_offset = offset & ~(env->me_os_psize - 1);
+ const size_t paged_length = roundup_powerof2(
+ env->me_psize + offset - paged_offset, env->me_os_psize);
+ err = mdbx_msync(&env->me_dxb_mmap, paged_offset, paged_length, false);
+ } else {
+ MDBX_meta rollback = *head;
+ mdbx_meta_set_txnid(env, &rollback, undo_txnid);
+ rollback.mm_datasync_sign = MDBX_DATASIGN_WEAK;
+ err = mdbx_pwrite(env->me_fd, &rollback, sizeof(MDBX_meta),
+ (uint8_t *)head - (uint8_t *)env->me_map);
+ }
+ if (err) {
+ mdbx_error("error %d rollback from %" PRIaTXN ", to %" PRIaTXN
+ " as %" PRIaTXN,
+ err, head_txnid, meta.mm_txnid_a.inconsistent, undo_txnid);
+ return err;
+ }
+
+ mdbx_invalidate_mmap_noncoherent_cache(env->me_map,
+ pgno2bytes(env, NUM_METAS));
+ mdbx_ensure(env, undo_txnid == mdbx_meta_txnid_fluid(env, head));
+ mdbx_ensure(env, 0 == mdbx_meta_eq_mask(env));
+ continue;
+ }
+
+ if (!env->me_lck) {
+ /* LY: without-lck (read-only) mode, so it is imposible that other
+ * process made weak checkpoint. */
+ mdbx_error("%s", "without-lck, unable recovery/rollback");
+ return MDBX_WANNA_RECOVERY;
+ }
+
+ /* LY: assume just have a collision with other running process,
+ * or someone make a weak checkpoint */
+ mdbx_verbose("%s", "assume collision or online weak checkpoint");
+ break;
+ }
+
+ const MDBX_meta *head = mdbx_meta_head(env);
+ if (lck_rc == /* lck exclusive */ MDBX_RESULT_TRUE) {
+ /* re-check size after mmap */
+ if ((env->me_dxb_mmap.current & (env->me_os_psize - 1)) != 0 ||
+ env->me_dxb_mmap.current < used_bytes) {
+ mdbx_error("unacceptable/unexpected datafile size %" PRIuPTR,
+ env->me_dxb_mmap.current);
+ return MDBX_PROBLEM;
+ }
+ if (env->me_dxb_mmap.current != env->me_dbgeo.now &&
+ (env->me_flags & MDBX_RDONLY) == 0) {
+ meta.mm_geo.now = bytes2pgno(env, env->me_dxb_mmap.current);
+ mdbx_verbose("update meta-geo to filesize %" PRIuPTR " bytes, %" PRIaPGNO
+ " pages",
+ env->me_dxb_mmap.current, meta.mm_geo.now);
+ }
+
+ if (memcmp(&meta.mm_geo, &head->mm_geo, sizeof(meta.mm_geo))) {
+ const txnid_t txnid = mdbx_meta_txnid_stable(env, head);
+ const txnid_t next_txnid = safe64_txnid_next(txnid);
+ mdbx_verbose("updating meta.geo: "
+ "from l%" PRIaPGNO "-n%" PRIaPGNO "-u%" PRIaPGNO
+ "/s%u-g%u (txn#%" PRIaTXN "), "
+ "to l%" PRIaPGNO "-n%" PRIaPGNO "-u%" PRIaPGNO
+ "/s%u-g%u (txn#%" PRIaTXN ")",
+ head->mm_geo.lower, head->mm_geo.now, head->mm_geo.upper,
+ head->mm_geo.shrink, head->mm_geo.grow, txnid,
+ meta.mm_geo.lower, meta.mm_geo.now, meta.mm_geo.upper,
+ meta.mm_geo.shrink, meta.mm_geo.grow, next_txnid);
+
+ mdbx_ensure(env, mdbx_meta_eq(env, &meta, head));
+ mdbx_meta_set_txnid(env, &meta, next_txnid);
+ *env->me_unsynced_pages += 1;
+ err = mdbx_sync_locked(env, env->me_flags | MDBX_SHRINK_ALLOWED, &meta);
+ if (err) {
+ mdbx_error("error %d, while updating meta.geo: "
+ "from l%" PRIaPGNO "-n%" PRIaPGNO "-u%" PRIaPGNO
+ "/s%u-g%u (txn#%" PRIaTXN "), "
+ "to l%" PRIaPGNO "-n%" PRIaPGNO "-u%" PRIaPGNO
+ "/s%u-g%u (txn#%" PRIaTXN ")",
+ err, head->mm_geo.lower, head->mm_geo.now,
+ head->mm_geo.upper, head->mm_geo.shrink, head->mm_geo.grow,
+ txnid, meta.mm_geo.lower, meta.mm_geo.now, meta.mm_geo.upper,
+ meta.mm_geo.shrink, meta.mm_geo.grow, next_txnid);
+ return err;
+ }
+ }
+ }
+
+ return rc;
+}
+
+/******************************************************************************/
+
+/* Open and/or initialize the lock region for the environment. */
+static int __cold mdbx_setup_lck(MDBX_env *env, char *lck_pathname,
+ mode_t mode) {
+ mdbx_assert(env, env->me_fd != INVALID_HANDLE_VALUE);
+ mdbx_assert(env, env->me_lfd == INVALID_HANDLE_VALUE);
+
+ int err = mdbx_openfile(lck_pathname, O_RDWR | O_CREAT, mode, &env->me_lfd,
+ (env->me_flags & MDBX_EXCLUSIVE) ? true : false);
+ if (err != MDBX_SUCCESS) {
+ if (!(err == MDBX_ENOFILE && (env->me_flags & MDBX_EXCLUSIVE)) &&
+ !((err == MDBX_EROFS || err == MDBX_EACCESS || err == MDBX_EPERM) &&
+ (env->me_flags & MDBX_RDONLY)))
+ return err;
+
+ /* LY: without-lck mode (e.g. exclusive or on read-only filesystem) */
+ /* beginning of a locked section ---------------------------------------- */
+ lcklist_lock();
+ mdbx_assert(env, env->me_lcklist_next == nullptr);
+ env->me_lfd = INVALID_HANDLE_VALUE;
+ const int rc = mdbx_lck_seize(env);
+ if (MDBX_IS_ERROR(rc)) {
+ /* Calling lcklist_detach_locked() is required to restore POSIX-filelock
+ * and this job will be done by mdbx_env_close0(). */
+ lcklist_unlock();
+ return rc;
+ }
+ /* insert into inprocess lck-list */
+ env->me_lcklist_next = inprocess_lcklist_head;
+ inprocess_lcklist_head = env;
+ lcklist_unlock();
+ /* end of a locked section ---------------------------------------------- */
+
+ env->me_oldest = &env->me_lckless_stub.oldest;
+ env->me_sync_timestamp = &env->me_lckless_stub.sync_timestamp;
+ env->me_autosync_period = &env->me_lckless_stub.autosync_period;
+ env->me_unsynced_pages = &env->me_lckless_stub.autosync_pending;
+ env->me_autosync_threshold = &env->me_lckless_stub.autosync_threshold;
+ env->me_discarded_tail = &env->me_lckless_stub.discarded_tail;
+ env->me_meta_sync_txnid = &env->me_lckless_stub.meta_sync_txnid;
+ env->me_maxreaders = UINT_MAX;
+#ifdef MDBX_OSAL_LOCK
+ env->me_wmutex = &env->me_lckless_stub.wmutex;
+#endif
+ mdbx_debug("lck-setup:%s%s%s", " lck-less",
+ (env->me_flags & MDBX_RDONLY) ? " readonly" : "",
+ (rc == MDBX_RESULT_TRUE) ? " exclusive" : " cooperative");
+ return rc;
+ }
+
+ /* beginning of a locked section ------------------------------------------ */
+ lcklist_lock();
+ mdbx_assert(env, env->me_lcklist_next == nullptr);
+
+ /* Try to get exclusive lock. If we succeed, then
+ * nobody is using the lock region and we should initialize it. */
+ err = mdbx_lck_seize(env);
+ if (MDBX_IS_ERROR(err)) {
+ bailout:
+ /* Calling lcklist_detach_locked() is required to restore POSIX-filelock
+ * and this job will be done by mdbx_env_close0(). */
+ lcklist_unlock();
+ return err;
+ }
+
+ MDBX_env *inprocess_neighbor = nullptr;
+ if (err == MDBX_RESULT_TRUE) {
+ err = uniq_check(&env->me_lck_mmap, &inprocess_neighbor);
+ if (MDBX_IS_ERROR(err))
+ goto bailout;
+ if (inprocess_neighbor &&
+ ((mdbx_runtime_flags & MDBX_DBG_LEGACY_MULTIOPEN) == 0 ||
+ (inprocess_neighbor->me_flags & MDBX_EXCLUSIVE) != 0)) {
+ err = MDBX_BUSY;
+ goto bailout;
+ }
+ }
+ const int lck_seize_rc = err;
+
+ mdbx_debug("lck-setup:%s%s%s", " with-lck",
+ (env->me_flags & MDBX_RDONLY) ? " readonly" : "",
+ (lck_seize_rc == MDBX_RESULT_TRUE) ? " exclusive"
+ : " cooperative");
+
+ uint64_t size;
+ err = mdbx_filesize(env->me_lfd, &size);
+ if (unlikely(err != MDBX_SUCCESS))
+ goto bailout;
+
+ if (lck_seize_rc == MDBX_RESULT_TRUE) {
+ size = roundup_powerof2(env->me_maxreaders * sizeof(MDBX_reader) +
+ sizeof(MDBX_lockinfo),
+ env->me_os_psize);
+#ifndef NDEBUG
+ err = mdbx_ftruncate(env->me_lfd, 0);
+ if (unlikely(err != MDBX_SUCCESS))
+ goto bailout;
+#endif
+ mdbx_jitter4testing(false);
+ } else {
+ if (env->me_flags & MDBX_EXCLUSIVE) {
+ err = MDBX_BUSY;
+ goto bailout;
+ }
+ if (size > INT_MAX || (size & (env->me_os_psize - 1)) != 0 ||
+ size < env->me_os_psize) {
+ mdbx_error("lck-file has invalid size %" PRIu64 " bytes", size);
+ err = MDBX_PROBLEM;
+ goto bailout;
+ }
+ }
+
+ const size_t maxreaders =
+ ((size_t)size - sizeof(MDBX_lockinfo)) / sizeof(MDBX_reader);
+ if (size > 65536 || maxreaders < 2 || maxreaders > MDBX_READERS_LIMIT) {
+ mdbx_error("lck-size too big (up to %" PRIuPTR " readers)", maxreaders);
+ err = MDBX_PROBLEM;
+ goto bailout;
+ }
+ env->me_maxreaders = (unsigned)maxreaders;
+
+ err = mdbx_mmap(MDBX_WRITEMAP, &env->me_lck_mmap, (size_t)size, (size_t)size,
+ lck_seize_rc);
+ if (unlikely(err != MDBX_SUCCESS))
+ goto bailout;
+
+#ifdef MADV_DODUMP
+ (void)madvise(env->me_lck, size, MADV_DODUMP);
+#endif
+
+#ifdef MADV_WILLNEED
+ if (madvise(env->me_lck, size, MADV_WILLNEED) < 0)
+ goto bailout;
+#endif
+
+ if (lck_seize_rc == MDBX_RESULT_TRUE) {
+ /* LY: exlcusive mode, reset lck */
+ memset(env->me_lck, 0, (size_t)size);
+ mdbx_jitter4testing(false);
+ env->me_lck->mti_magic_and_version = MDBX_LOCK_MAGIC;
+ env->me_lck->mti_os_and_format = MDBX_LOCK_FORMAT;
+ } else {
+ if (env->me_lck->mti_magic_and_version != MDBX_LOCK_MAGIC) {
+ mdbx_error("%s", "lock region has invalid magic/version");
+ err = ((env->me_lck->mti_magic_and_version >> 8) != MDBX_MAGIC)
+ ? MDBX_INVALID
+ : MDBX_VERSION_MISMATCH;
+ goto bailout;
+ }
+ if (env->me_lck->mti_os_and_format != MDBX_LOCK_FORMAT) {
+ mdbx_error("lock region has os/format 0x%" PRIx32 ", expected 0x%" PRIx32,
+ env->me_lck->mti_os_and_format, MDBX_LOCK_FORMAT);
+ err = MDBX_VERSION_MISMATCH;
+ goto bailout;
+ }
+ }
+
+ err = mdbx_lck_init(env, inprocess_neighbor, lck_seize_rc);
+ if (MDBX_IS_ERROR(err))
+ goto bailout;
+
+ mdbx_ensure(env, env->me_lcklist_next == nullptr);
+ /* insert into inprocess lck-list */
+ env->me_lcklist_next = inprocess_lcklist_head;
+ inprocess_lcklist_head = env;
+ lcklist_unlock();
+ /* end of a locked section ------------------------------------------------ */
+
+ mdbx_assert(env, !MDBX_IS_ERROR(lck_seize_rc));
+ env->me_oldest = &env->me_lck->mti_oldest_reader;
+ env->me_sync_timestamp = &env->me_lck->mti_sync_timestamp;
+ env->me_autosync_period = &env->me_lck->mti_autosync_period;
+ env->me_unsynced_pages = &env->me_lck->mti_unsynced_pages;
+ env->me_autosync_threshold = &env->me_lck->mti_autosync_threshold;
+ env->me_discarded_tail = &env->me_lck->mti_discarded_tail;
+ env->me_meta_sync_txnid = &env->me_lck->mti_meta_sync_txnid;
+#ifdef MDBX_OSAL_LOCK
+ env->me_wmutex = &env->me_lck->mti_wmutex;
+#endif
+ return lck_seize_rc;
+}
+
+__cold int mdbx_is_readahead_reasonable(size_t volume, intptr_t redundancy) {
+ if (volume <= 1024 * 1024 * 4ul)
+ return MDBX_RESULT_TRUE;
+
+ const intptr_t pagesize = mdbx_syspagesize();
+ if (unlikely(pagesize < MIN_PAGESIZE || !is_powerof2(pagesize)))
+ return MDBX_INCOMPATIBLE;
+
+#if defined(_WIN32) || defined(_WIN64)
+ MEMORYSTATUSEX info;
+ memset(&info, 0, sizeof(info));
+ info.dwLength = sizeof(info);
+ if (!GlobalMemoryStatusEx(&info))
+ return GetLastError();
+#endif
+ const int log2page = log2n(pagesize);
+
+#if defined(_WIN32) || defined(_WIN64)
+ const intptr_t total_ram_pages = (intptr_t)(info.ullTotalPhys >> log2page);
+#elif defined(_SC_PHYS_PAGES)
+ const intptr_t total_ram_pages = sysconf(_SC_PHYS_PAGES);
+ if (total_ram_pages == -1)
+ return errno;
+#elif defined(_SC_AIX_REALMEM)
+ const intptr_t total_ram_Kb = sysconf(_SC_AIX_REALMEM);
+ if (total_ram_Kb == -1)
+ return errno;
+ const intptr_t total_ram_pages = (total_ram_Kb << 10) >> log2page;
+#elif defined(HW_USERMEM) || defined(HW_PHYSMEM64) || defined(HW_MEMSIZE) || \
+ defined(HW_PHYSMEM)
+ size_t ram, len = sizeof(ram);
+ static const int mib[] = {
+ CTL_HW,
+#if defined(HW_USERMEM)
+ HW_USERMEM
+#elif defined(HW_PHYSMEM64)
+ HW_PHYSMEM64
+#elif defined(HW_MEMSIZE)
+ HW_MEMSIZE
+#else
+ HW_PHYSMEM
+#endif
+ };
+ if (sysctl(
+#ifdef SYSCTL_LEGACY_NONCONST_MIB
+ (int *)
+#endif
+ mib,
+ ARRAY_LENGTH(mib), &ram, &len, NULL, 0) != 0)
+ return errno;
+ if (len != sizeof(ram))
+ return MDBX_ENOSYS;
+ const intptr_t total_ram_pages = (intptr_t)(ram >> log2page);
+#else
+#error "FIXME: Get User-accessible or physical RAM"
+#endif
+ if (total_ram_pages < 1)
+ return MDBX_ENOSYS;
+
+ const intptr_t volume_pages = (volume + pagesize - 1) >> log2page;
+ const intptr_t redundancy_pages =
+ (redundancy < 0) ? -(intptr_t)((-redundancy + pagesize - 1) >> log2page)
+ : (intptr_t)(redundancy + pagesize - 1) >> log2page;
+ if (volume_pages >= total_ram_pages ||
+ volume_pages + redundancy_pages >= total_ram_pages)
+ return MDBX_RESULT_FALSE;
+
+#if defined(_WIN32) || defined(_WIN64)
+ const intptr_t avail_ram_pages = (intptr_t)(info.ullAvailPhys >> log2page);
+#elif defined(_SC_AVPHYS_PAGES)
+ const intptr_t avail_ram_pages = sysconf(_SC_AVPHYS_PAGES);
+ if (avail_ram_pages == -1)
+ return errno;
+#elif defined(__MACH__)
+ mach_msg_type_number_t count = HOST_VM_INFO_COUNT;
+ vm_statistics_data_t vmstat;
+ mach_port_t mport = mach_host_self();
+ kern_return_t kerr = host_statistics(mach_host_self(), HOST_VM_INFO,
+ (host_info_t)&vmstat, &count);
+ mach_port_deallocate(mach_task_self(), mport);
+ if (unlikely(kerr != KERN_SUCCESS))
+ return MDBX_ENOSYS;
+ const intptr_t avail_ram_pages = vmstat.free_count;
+#elif defined(VM_TOTAL) || defined(VM_METER)
+ struct vmtotal info;
+ size_t len = sizeof(info);
+ static const int mib[] = {
+ CTL_VM,
+#if defined(VM_TOTAL)
+ VM_TOTAL
+#elif defined(VM_METER)
+ VM_METER
+#endif
+ };
+ if (sysctl(
+#ifdef SYSCTL_LEGACY_NONCONST_MIB
+ (int *)
+#endif
+ mib,
+ ARRAY_LENGTH(mib), &info, &len, NULL, 0) != 0)
+ return errno;
+ if (len != sizeof(info))
+ return MDBX_ENOSYS;
+ const intptr_t avail_ram_pages = info.t_free;
+#else
+#error "FIXME: Get Available RAM"
+#endif
+ if (avail_ram_pages < 1)
+ return MDBX_ENOSYS;
+
+ return (volume_pages + redundancy_pages >= avail_ram_pages)
+ ? MDBX_RESULT_FALSE
+ : MDBX_RESULT_TRUE;
+}
+
+/* Only a subset of the mdbx_env flags can be changed
+ * at runtime. Changing other flags requires closing the
+ * environment and re-opening it with the new flags. */
+#define CHANGEABLE \
+ (MDBX_NOSYNC | MDBX_NOMETASYNC | MDBX_MAPASYNC | MDBX_NOMEMINIT | \
+ MDBX_COALESCE | MDBX_PAGEPERTURB)
+#define CHANGELESS \
+ (MDBX_NOSUBDIR | MDBX_RDONLY | MDBX_WRITEMAP | MDBX_NOTLS | MDBX_NORDAHEAD | \
+ MDBX_LIFORECLAIM | MDBX_EXCLUSIVE)
+
+#if VALID_FLAGS & PERSISTENT_FLAGS & (CHANGEABLE | CHANGELESS)
+#error "Persistent DB flags & env flags overlap, but both go in mm_flags"
+#endif
+
+int __cold mdbx_env_open(MDBX_env *env, const char *path, unsigned flags,
+ mode_t mode) {
+ if (unlikely(!env || !path))
+ return MDBX_EINVAL;
+
+ if (unlikely(env->me_signature != MDBX_ME_SIGNATURE))
+ return MDBX_EBADSIGN;
+
+ if (flags & ~(CHANGEABLE | CHANGELESS))
+ return MDBX_EINVAL;
+
+ if (env->me_fd != INVALID_HANDLE_VALUE ||
+ (env->me_flags & MDBX_ENV_ACTIVE) != 0)
+ return MDBX_EPERM;
+
+ size_t len_full, len = strlen(path);
+ if (flags & MDBX_NOSUBDIR) {
+ len_full = len + sizeof(MDBX_LOCK_SUFFIX) + len + 1;
+ } else {
+ len_full = len + sizeof(MDBX_LOCKNAME) + len + sizeof(MDBX_DATANAME);
+ }
+ char *lck_pathname = mdbx_malloc(len_full);
+ if (!lck_pathname)
+ return MDBX_ENOMEM;
+
+ char *dxb_pathname;
+ if (flags & MDBX_NOSUBDIR) {
+ dxb_pathname = lck_pathname + len + sizeof(MDBX_LOCK_SUFFIX);
+ sprintf(lck_pathname, "%s" MDBX_LOCK_SUFFIX, path);
+ strcpy(dxb_pathname, path);
+ } else {
+ dxb_pathname = lck_pathname + len + sizeof(MDBX_LOCKNAME);
+ sprintf(lck_pathname, "%s" MDBX_LOCKNAME, path);
+ sprintf(dxb_pathname, "%s" MDBX_DATANAME, path);
+ }
+
+ int rc = MDBX_SUCCESS;
+ flags |= env->me_flags;
+ if (flags & MDBX_RDONLY) {
+ /* LY: silently ignore irrelevant flags when
+ * we're only getting read access */
+ flags &= ~(MDBX_WRITEMAP | MDBX_MAPASYNC | MDBX_NOSYNC | MDBX_NOMETASYNC |
+ MDBX_COALESCE | MDBX_LIFORECLAIM | MDBX_NOMEMINIT);
+ } else {
+ env->me_dirtylist = mdbx_calloc(MDBX_DPL_TXNFULL + 1, sizeof(MDBX_DP));
+ if (!env->me_dirtylist)
+ rc = MDBX_ENOMEM;
+ }
+
+ const uint32_t saved_me_flags = env->me_flags;
+ env->me_flags = (flags & ~MDBX_FATAL_ERROR) | MDBX_ENV_ACTIVE;
+ if (rc)
+ goto bailout;
+
+ env->me_path = mdbx_strdup(path);
+ env->me_dbxs = mdbx_calloc(env->me_maxdbs, sizeof(MDBX_dbx));
+ env->me_dbflags = mdbx_calloc(env->me_maxdbs, sizeof(env->me_dbflags[0]));
+ env->me_dbiseqs = mdbx_calloc(env->me_maxdbs, sizeof(env->me_dbiseqs[0]));
+ if (!(env->me_dbxs && env->me_path && env->me_dbflags && env->me_dbiseqs)) {
+ rc = MDBX_ENOMEM;
+ goto bailout;
+ }
+ env->me_dbxs[FREE_DBI].md_cmp =
+ mdbx_cmp_int_align4; /* aligned MDBX_INTEGERKEY */
+
+ int oflags;
+ if (F_ISSET(flags, MDBX_RDONLY))
+ oflags = O_RDONLY;
+ else if (mode != 0) {
+ if ((flags & MDBX_NOSUBDIR) == 0) {
+#if defined(_WIN32) || defined(_WIN64)
+ if (!CreateDirectoryA(path, nullptr)) {
+ rc = GetLastError();
+ if (rc != ERROR_ALREADY_EXISTS)
+ goto bailout;
+ }
+#else
+ const mode_t dir_mode =
+ (/* inherit read/write permissions for group and others */ mode &
+ (S_IRGRP | S_IWGRP | S_IROTH | S_IWOTH)) |
+ /* always add read/write/search for owner */ S_IRWXU |
+ ((mode & S_IRGRP) ? /* +search if readable by group */ S_IXGRP : 0) |
+ ((mode & S_IROTH) ? /* +search if readable by others */ S_IXOTH : 0);
+ if (mkdir(path, dir_mode)) {
+ rc = errno;
+ if (rc != EEXIST)
+ goto bailout;
+ }
+#endif
+ }
+ oflags = O_RDWR | O_CREAT;
+ } else
+ oflags = O_RDWR;
+
+ rc = mdbx_openfile(dxb_pathname, oflags, mode, &env->me_fd,
+ (env->me_flags & MDBX_EXCLUSIVE) ? true : false);
+ if (rc != MDBX_SUCCESS)
+ goto bailout;
+
+ const int lck_rc = mdbx_setup_lck(env, lck_pathname, mode);
+ if (MDBX_IS_ERROR(lck_rc)) {
+ rc = lck_rc;
+ goto bailout;
+ }
+
+ const int dxb_rc = mdbx_setup_dxb(env, lck_rc);
+ if (MDBX_IS_ERROR(dxb_rc)) {
+ rc = dxb_rc;
+ goto bailout;
+ }
+
+ mdbx_debug("opened dbenv %p", (void *)env);
+ if (env->me_lck) {
+ const unsigned mode_flags =
+ MDBX_WRITEMAP | MDBX_NOSYNC | MDBX_NOMETASYNC | MDBX_MAPASYNC;
+ if (lck_rc == MDBX_RESULT_TRUE) {
+ env->me_lck->mti_envmode = env->me_flags & (mode_flags | MDBX_RDONLY);
+ rc = mdbx_lck_downgrade(env);
+ mdbx_debug("lck-downgrade-%s: rc %i",
+ (env->me_flags & MDBX_EXCLUSIVE) ? "partial" : "full", rc);
+ if (rc != MDBX_SUCCESS)
+ goto bailout;
+ } else {
+ rc = mdbx_reader_check0(env, false, NULL);
+ if (MDBX_IS_ERROR(rc))
+ goto bailout;
+ if ((env->me_flags & MDBX_RDONLY) == 0) {
+ while (env->me_lck->mti_envmode == MDBX_RDONLY) {
+ if (atomic_cas32(&env->me_lck->mti_envmode, MDBX_RDONLY,
+ env->me_flags & mode_flags))
+ break;
+ atomic_yield();
+ }
+ if ((env->me_lck->mti_envmode ^ env->me_flags) & mode_flags) {
+ mdbx_error("%s", "current mode/flags incompatible with requested");
+ rc = MDBX_INCOMPATIBLE;
+ goto bailout;
+ }
+ }
+ }
+
+ if ((env->me_flags & MDBX_NOTLS) == 0) {
+ rc = mdbx_rthc_alloc(&env->me_txkey, &env->me_lck->mti_readers[0],
+ &env->me_lck->mti_readers[env->me_maxreaders]);
+ if (unlikely(rc != MDBX_SUCCESS))
+ goto bailout;
+ env->me_flags |= MDBX_ENV_TXKEY;
+ }
+ }
+
+ if ((flags & MDBX_RDONLY) == 0) {
+ rc = MDBX_ENOMEM;
+ MDBX_txn *txn;
+ int tsize = sizeof(MDBX_txn),
+ size =
+ tsize + env->me_maxdbs * (sizeof(MDBX_db) + sizeof(MDBX_cursor *) +
+ sizeof(unsigned) + 1);
+ if ((env->me_pbuf = mdbx_calloc(
+ 1 /* page buffer */ + 1 /* page killer bufer */, env->me_psize)) &&
+ (txn = mdbx_calloc(1, size))) {
+ txn->mt_dbs = (MDBX_db *)((char *)txn + tsize);
+ txn->mt_cursors = (MDBX_cursor **)(txn->mt_dbs + env->me_maxdbs);
+ txn->mt_dbiseqs = (unsigned *)(txn->mt_cursors + env->me_maxdbs);
+ txn->mt_dbflags = (uint8_t *)(txn->mt_dbiseqs + env->me_maxdbs);
+ txn->mt_env = env;
+ txn->mt_dbxs = env->me_dbxs;
+ txn->mt_flags = MDBX_TXN_FINISHED;
+ env->me_txn0 = txn;
+ txn->tw.retired_pages = mdbx_pnl_alloc(MDBX_PNL_INITIAL);
+ txn->tw.reclaimed_pglist = mdbx_pnl_alloc(MDBX_PNL_INITIAL);
+ if (txn->tw.retired_pages && txn->tw.reclaimed_pglist)
+ rc = MDBX_SUCCESS;
+ }
+ }
+
+#if MDBX_DEBUG
+ if (rc == MDBX_SUCCESS) {
+ MDBX_meta *meta = mdbx_meta_head(env);
+ MDBX_db *db = &meta->mm_dbs[MAIN_DBI];
+
+ mdbx_debug("opened database version %u, pagesize %u",
+ (uint8_t)meta->mm_magic_and_version, env->me_psize);
+ mdbx_debug("using meta page %" PRIaPGNO ", txn %" PRIaTXN,
+ data_page(meta)->mp_pgno, mdbx_meta_txnid_fluid(env, meta));
+ mdbx_debug("depth: %u", db->md_depth);
+ mdbx_debug("entries: %" PRIu64, db->md_entries);
+ mdbx_debug("branch pages: %" PRIaPGNO, db->md_branch_pages);
+ mdbx_debug("leaf pages: %" PRIaPGNO, db->md_leaf_pages);
+ mdbx_debug("overflow pages: %" PRIaPGNO, db->md_overflow_pages);
+ mdbx_debug("root: %" PRIaPGNO, db->md_root);
+ mdbx_debug("schema_altered: %" PRIaTXN, db->md_mod_txnid);
+ }
+#endif
+
+bailout:
+ if (rc) {
+ rc = mdbx_env_close0(env) ? MDBX_PANIC : rc;
+ env->me_flags = saved_me_flags | MDBX_FATAL_ERROR;
+ }
+ mdbx_free(lck_pathname);
+ return rc;
+}
+
+/* Destroy resources from mdbx_env_open(), clear our readers & DBIs */
+static int __cold mdbx_env_close0(MDBX_env *env) {
+ if (!(env->me_flags & MDBX_ENV_ACTIVE)) {
+ mdbx_ensure(env, env->me_lcklist_next == nullptr);
+ return MDBX_SUCCESS;
+ }
+
+ env->me_flags &= ~MDBX_ENV_ACTIVE;
+ env->me_oldest = nullptr;
+ env->me_sync_timestamp = nullptr;
+ env->me_autosync_period = nullptr;
+ env->me_unsynced_pages = nullptr;
+ env->me_autosync_threshold = nullptr;
+ env->me_discarded_tail = nullptr;
+ env->me_meta_sync_txnid = nullptr;
+ if (env->me_flags & MDBX_ENV_TXKEY)
+ mdbx_rthc_remove(env->me_txkey);
+
+ lcklist_lock();
+ const int rc = lcklist_detach_locked(env);
+ lcklist_unlock();
+
+ if (env->me_map) {
+ mdbx_munmap(&env->me_dxb_mmap);
+#ifdef MDBX_USE_VALGRIND
+ VALGRIND_DISCARD(env->me_valgrind_handle);
+ env->me_valgrind_handle = -1;
+#endif
+ }
+ if (env->me_fd != INVALID_HANDLE_VALUE) {
+ (void)mdbx_closefile(env->me_fd);
+ env->me_fd = INVALID_HANDLE_VALUE;
+ }
+
+ if (env->me_lck)
+ mdbx_munmap(&env->me_lck_mmap);
+
+ if (env->me_lfd != INVALID_HANDLE_VALUE) {
+ (void)mdbx_closefile(env->me_lfd);
+ env->me_lfd = INVALID_HANDLE_VALUE;
+ }
+
+ if (env->me_dbxs) {
+ for (unsigned i = env->me_maxdbs; --i >= CORE_DBS;)
+ mdbx_free(env->me_dbxs[i].md_name.iov_base);
+ mdbx_free(env->me_dbxs);
+ }
+ mdbx_free(env->me_pbuf);
+ mdbx_free(env->me_dbiseqs);
+ mdbx_free(env->me_dbflags);
+ mdbx_free(env->me_path);
+ mdbx_free(env->me_dirtylist);
+ if (env->me_txn0) {
+ mdbx_txl_free(env->me_txn0->tw.lifo_reclaimed);
+ mdbx_pnl_free(env->me_txn0->tw.retired_pages);
+ mdbx_pnl_free(env->me_txn0->tw.spill_pages);
+ mdbx_pnl_free(env->me_txn0->tw.reclaimed_pglist);
+ mdbx_free(env->me_txn0);
+ }
+ env->me_flags = 0;
+ return rc;
+}
+
+int __cold mdbx_env_close_ex(MDBX_env *env, int dont_sync) {
+ MDBX_page *dp;
+ int rc = MDBX_SUCCESS;
+
+ if (unlikely(!env))
+ return MDBX_EINVAL;
+
+ if (unlikely(env->me_signature != MDBX_ME_SIGNATURE))
+ return MDBX_EBADSIGN;
+
+#if MDBX_TXN_CHECKPID || !(defined(_WIN32) || defined(_WIN64))
+ /* Check the PID even if MDBX_TXN_CHECKPID=0 on non-Windows
+ * platforms (i.e. where fork() is available).
+ * This is required to legitimize a call after fork()
+ * from a child process, that should be allowed to free resources. */
+ if (unlikely(env->me_pid != mdbx_getpid()))
+ env->me_flags |= MDBX_FATAL_ERROR;
+#endif /* MDBX_TXN_CHECKPID */
+
+ if ((env->me_flags & (MDBX_RDONLY | MDBX_FATAL_ERROR)) == 0) {
+ if (env->me_txn0 && env->me_txn0->mt_owner &&
+ env->me_txn0->mt_owner != mdbx_thread_self())
+ return MDBX_BUSY;
+ if (!dont_sync) {
+#if defined(_WIN32) || defined(_WIN64)
+ /* On windows, without blocking is impossible to determine whether another
+ * process is running a writing transaction or not.
+ * Because in the "owner died" condition kernel don't release
+ * file lock immediately. */
+ rc = mdbx_env_sync_ex(env, true, false);
+ rc = (rc == MDBX_RESULT_TRUE) ? MDBX_SUCCESS : rc;
+#else
+ rc = mdbx_env_sync_ex(env, true, true);
+ rc = (rc == MDBX_BUSY || rc == EAGAIN || rc == EACCES || rc == EBUSY ||
+ rc == EWOULDBLOCK || rc == MDBX_RESULT_TRUE)
+ ? MDBX_SUCCESS
+ : rc;
+#endif
+ }
+ }
+
+ while ((dp = env->me_dpages) != NULL) {
+ ASAN_UNPOISON_MEMORY_REGION(&dp->mp_next, sizeof(dp->mp_next));
+ VALGRIND_MAKE_MEM_DEFINED(&dp->mp_next, sizeof(dp->mp_next));
+ env->me_dpages = dp->mp_next;
+ mdbx_free(dp);
+ }
+ VALGRIND_DESTROY_MEMPOOL(env);
+
+ rc = mdbx_env_close0(env) ? MDBX_PANIC : rc;
+ mdbx_ensure(env, mdbx_fastmutex_destroy(&env->me_dbi_lock) == MDBX_SUCCESS);
+#if defined(_WIN32) || defined(_WIN64)
+ /* me_remap_guard don't have destructor (Slim Reader/Writer Lock) */
+ DeleteCriticalSection(&env->me_windowsbug_lock);
+#else
+ mdbx_ensure(env,
+ mdbx_fastmutex_destroy(&env->me_remap_guard) == MDBX_SUCCESS);
+#endif /* Windows */
+
+#ifdef MDBX_OSAL_LOCK
+ mdbx_ensure(env, mdbx_fastmutex_destroy(&env->me_lckless_stub.wmutex) ==
+ MDBX_SUCCESS);
+#endif
+
+ mdbx_ensure(env, env->me_lcklist_next == nullptr);
+ env->me_pid = 0;
+ env->me_signature = 0;
+ mdbx_free(env);
+
+ return rc;
+}
+
+__cold int mdbx_env_close(MDBX_env *env) {
+ return mdbx_env_close_ex(env, false);
+}
+
+/* Compare two items pointing at aligned unsigned int's. */
+static int __hot mdbx_cmp_int_align4(const MDBX_val *a, const MDBX_val *b) {
+ mdbx_assert(NULL, a->iov_len == b->iov_len);
+ switch (a->iov_len) {
+ case 4:
+ return CMP2INT(unaligned_peek_u32(4, a->iov_base),
+ unaligned_peek_u32(4, b->iov_base));
+ case 8:
+ return CMP2INT(unaligned_peek_u64(4, a->iov_base),
+ unaligned_peek_u64(4, b->iov_base));
+ default:
+ mdbx_assert_fail(NULL, "invalid size for INTEGERKEY/INTEGERDUP", __func__,
+ __LINE__);
+ return 0;
+ }
+}
+
+/* Compare two items pointing at 2-byte aligned unsigned int's. */
+static int __hot mdbx_cmp_int_align2(const MDBX_val *a, const MDBX_val *b) {
+ mdbx_assert(NULL, a->iov_len == b->iov_len);
+ switch (a->iov_len) {
+ case 4:
+ return CMP2INT(unaligned_peek_u32(2, a->iov_base),
+ unaligned_peek_u32(2, b->iov_base));
+ case 8:
+ return CMP2INT(unaligned_peek_u64(2, a->iov_base),
+ unaligned_peek_u64(2, b->iov_base));
+ default:
+ mdbx_assert_fail(NULL, "invalid size for INTEGERKEY/INTEGERDUP", __func__,
+ __LINE__);
+ return 0;
+ }
+}
+
+/* Compare two items pointing at unsigneds of unknown alignment.
+ *
+ * This is also set as MDBX_INTEGERDUP|MDBX_DUPFIXED's MDBX_dbx.md_dcmp. */
+static int __hot mdbx_cmp_int_unaligned(const MDBX_val *a, const MDBX_val *b) {
+ mdbx_assert(NULL, a->iov_len == b->iov_len);
+ switch (a->iov_len) {
+ case 4:
+ return CMP2INT(unaligned_peek_u32(1, a->iov_base),
+ unaligned_peek_u32(1, b->iov_base));
+ case 8:
+ return CMP2INT(unaligned_peek_u64(1, a->iov_base),
+ unaligned_peek_u64(1, b->iov_base));
+ default:
+ mdbx_assert_fail(NULL, "invalid size for INTEGERKEY/INTEGERDUP", __func__,
+ __LINE__);
+ return 0;
+ }
+}
+
+/* Compare two items lexically */
+static int __hot mdbx_cmp_memn(const MDBX_val *a, const MDBX_val *b) {
+ if (a->iov_len == b->iov_len)
+ return memcmp(a->iov_base, b->iov_base, a->iov_len);
+
+ const int diff_len = (a->iov_len < b->iov_len) ? -1 : 1;
+ const size_t shortest = (a->iov_len < b->iov_len) ? a->iov_len : b->iov_len;
+ int diff_data = memcmp(a->iov_base, b->iov_base, shortest);
+ return likely(diff_data) ? diff_data : diff_len;
+}
+
+/* Compare two items in reverse byte order */
+static int __hot mdbx_cmp_memnr(const MDBX_val *a, const MDBX_val *b) {
+ const uint8_t *pa = (const uint8_t *)a->iov_base + a->iov_len;
+ const uint8_t *pb = (const uint8_t *)b->iov_base + b->iov_len;
+ const size_t shortest = (a->iov_len < b->iov_len) ? a->iov_len : b->iov_len;
+
+ const uint8_t *const end = pa - shortest;
+ while (pa != end) {
+ int diff = *--pa - *--pb;
+ if (likely(diff))
+ return diff;
+ }
+ return CMP2INT(a->iov_len, b->iov_len);
+}
+
+/* Search for key within a page, using binary search.
+ * Returns the smallest entry larger or equal to the key.
+ * If exactp is non-null, stores whether the found entry was an exact match
+ * in *exactp (1 or 0).
+ * Updates the cursor index with the index of the found entry.
+ * If no entry larger or equal to the key is found, returns NULL. */
+static MDBX_node *__hot mdbx_node_search(MDBX_cursor *mc, MDBX_val *key,
+ int *exactp) {
+ int low, high;
+ int rc = 0;
+ MDBX_page *mp = mc->mc_pg[mc->mc_top];
+ MDBX_node *node = nullptr;
+ MDBX_val nodekey;
+ MDBX_cmp_func *cmp;
+ DKBUF;
+
+ const unsigned nkeys = page_numkeys(mp);
+
+ mdbx_debug("searching %u keys in %s %spage %" PRIaPGNO, nkeys,
+ IS_LEAF(mp) ? "leaf" : "branch", IS_SUBP(mp) ? "sub-" : "",
+ mp->mp_pgno);
+
+ low = IS_LEAF(mp) ? 0 : 1;
+ high = nkeys - 1;
+ cmp = mc->mc_dbx->md_cmp;
+
+ /* Branch pages have no data, so if using integer keys,
+ * alignment is guaranteed. Use faster mdbx_cmp_int_ai.
+ */
+ if (cmp == mdbx_cmp_int_align2 && IS_BRANCH(mp))
+ cmp = mdbx_cmp_int_align4;
+
+ unsigned i = 0;
+ if (IS_LEAF2(mp)) {
+ mdbx_cassert(mc, mp->mp_leaf2_ksize == mc->mc_db->md_xsize);
+ nodekey.iov_len = mp->mp_leaf2_ksize;
+ node = (MDBX_node *)(intptr_t)-1; /* fake */
+ while (low <= high) {
+ i = (low + high) >> 1;
+ nodekey.iov_base = page_leaf2key(mp, i, nodekey.iov_len);
+ mdbx_cassert(mc, (char *)mp + mc->mc_txn->mt_env->me_psize >=
+ (char *)nodekey.iov_base + nodekey.iov_len);
+ rc = cmp(key, &nodekey);
+ mdbx_debug("found leaf index %u [%s], rc = %i", i, DKEY(&nodekey), rc);
+ if (rc == 0)
+ break;
+ if (rc > 0)
+ low = i + 1;
+ else
+ high = i - 1;
+ }
+ } else {
+ while (low <= high) {
+ i = (low + high) >> 1;
+
+ node = page_node(mp, i);
+ nodekey.iov_len = node_ks(node);
+ nodekey.iov_base = node_key(node);
+ mdbx_cassert(mc, (char *)mp + mc->mc_txn->mt_env->me_psize >=
+ (char *)nodekey.iov_base + nodekey.iov_len);
+
+ rc = cmp(key, &nodekey);
+ if (IS_LEAF(mp))
+ mdbx_debug("found leaf index %u [%s], rc = %i", i, DKEY(&nodekey), rc);
+ else
+ mdbx_debug("found branch index %u [%s -> %" PRIaPGNO "], rc = %i", i,
+ DKEY(&nodekey), node_pgno(node), rc);
+ if (rc == 0)
+ break;
+ if (rc > 0)
+ low = i + 1;
+ else
+ high = i - 1;
+ }
+ }
+
+ if (rc > 0) /* Found entry is less than the key. */
+ i++; /* Skip to get the smallest entry larger than key. */
+
+ if (exactp)
+ *exactp = (rc == 0 && nkeys > 0);
+ /* store the key index */
+ mdbx_cassert(mc, i <= UINT16_MAX);
+ mc->mc_ki[mc->mc_top] = (indx_t)i;
+ if (i >= nkeys)
+ /* There is no entry larger or equal to the key. */
+ return NULL;
+
+ /* page_node is fake for LEAF2 */
+ return IS_LEAF2(mp) ? node : page_node(mp, i);
+}
+
+#if 0 /* unused for now */
+static void mdbx_cursor_adjust(MDBX_cursor *mc, func) {
+ MDBX_cursor *m2;
+
+ for (m2 = mc->mc_txn->mt_cursors[mc->mc_dbi]; m2; m2 = m2->mc_next) {
+ if (m2->mc_pg[m2->mc_top] == mc->mc_pg[mc->mc_top]) {
+ func(mc, m2);
+ }
+ }
+}
+#endif
+
+/* Pop a page off the top of the cursor's stack. */
+static void mdbx_cursor_pop(MDBX_cursor *mc) {
+ if (mc->mc_snum) {
+ mdbx_debug("popped page %" PRIaPGNO " off db %d cursor %p",
+ mc->mc_pg[mc->mc_top]->mp_pgno, DDBI(mc), (void *)mc);
+
+ mc->mc_snum--;
+ if (mc->mc_snum) {
+ mc->mc_top--;
+ } else {
+ mc->mc_flags &= ~C_INITIALIZED;
+ }
+ }
+}
+
+/* Push a page onto the top of the cursor's stack.
+ * Set MDBX_TXN_ERROR on failure. */
+static int mdbx_cursor_push(MDBX_cursor *mc, MDBX_page *mp) {
+ mdbx_debug("pushing page %" PRIaPGNO " on db %d cursor %p", mp->mp_pgno,
+ DDBI(mc), (void *)mc);
+
+ if (unlikely(mc->mc_snum >= CURSOR_STACK)) {
+ mc->mc_txn->mt_flags |= MDBX_TXN_ERROR;
+ return MDBX_CURSOR_FULL;
+ }
+
+ mdbx_cassert(mc, mc->mc_snum < UINT16_MAX);
+ mc->mc_top = mc->mc_snum++;
+ mc->mc_pg[mc->mc_top] = mp;
+ mc->mc_ki[mc->mc_top] = 0;
+
+ return MDBX_SUCCESS;
+}
+
+/* Find the address of the page corresponding to a given page number.
+ * Set MDBX_TXN_ERROR on failure.
+ *
+ * [in] mc the cursor accessing the page.
+ * [in] pgno the page number for the page to retrieve.
+ * [out] ret address of a pointer where the page's address will be
+ * stored.
+ * [out] lvl dirtylist inheritance level of found page. 1=current txn,
+ * 0=mapped page.
+ *
+ * Returns 0 on success, non-zero on failure. */
+__hot static int mdbx_page_get(MDBX_cursor *mc, pgno_t pgno, MDBX_page **ret,
+ int *lvl) {
+ MDBX_txn *txn = mc->mc_txn;
+ if (unlikely(pgno >= txn->mt_next_pgno)) {
+ mdbx_debug("page %" PRIaPGNO " not found", pgno);
+ txn->mt_flags |= MDBX_TXN_ERROR;
+ return MDBX_PAGE_NOTFOUND;
+ }
+
+ MDBX_env *env = txn->mt_env;
+ MDBX_page *p = NULL;
+ int level;
+ if ((txn->mt_flags & (MDBX_RDONLY | MDBX_WRITEMAP)) == 0) {
+ level = 1;
+ do {
+ /* Spilled pages were dirtied in this txn and flushed
+ * because the dirty list got full. Bring this page
+ * back in from the map (but don't unspill it here,
+ * leave that unless page_touch happens again). */
+ if (txn->tw.spill_pages && mdbx_pnl_exist(txn->tw.spill_pages, pgno << 1))
+ goto mapped;
+ p = mdbx_dpl_find(txn->tw.dirtylist, pgno);
+ if (p)
+ goto done;
+ level++;
+ } while ((txn = txn->mt_parent) != NULL);
+ }
+ level = 0;
+
+mapped:
+ p = pgno2page(env, pgno);
+
+done:
+ txn = nullptr /* avoid future use */;
+ if (unlikely(p->mp_pgno != pgno)) {
+ mdbx_error("mismatch pgno %" PRIaPGNO " (actual) != %" PRIaPGNO
+ " (expected)",
+ p->mp_pgno, pgno);
+ return MDBX_CORRUPTED;
+ }
+
+ if (unlikely(p->mp_upper < p->mp_lower || ((p->mp_lower | p->mp_upper) & 1) ||
+ PAGEHDRSZ + p->mp_upper > env->me_psize) &&
+ !IS_OVERFLOW(p)) {
+ mdbx_error("invalid page lower(%u)/upper(%u), pg-limit %u", p->mp_lower,
+ p->mp_upper, page_space(env));
+ return MDBX_CORRUPTED;
+ }
+ /* TODO: more checks here, including p->mp_validator */
+
+ if (mdbx_audit_enabled()) {
+ int err = mdbx_page_check(env, p, true);
+ if (unlikely(err != MDBX_SUCCESS))
+ return err;
+ }
+
+ *ret = p;
+ if (lvl)
+ *lvl = level;
+ return MDBX_SUCCESS;
+}
+
+/* Finish mdbx_page_search() / mdbx_page_search_lowest().
+ * The cursor is at the root page, set up the rest of it. */
+__hot static int mdbx_page_search_root(MDBX_cursor *mc, MDBX_val *key,
+ int flags) {
+ MDBX_page *mp = mc->mc_pg[mc->mc_top];
+ int rc;
+ DKBUF;
+
+ while (IS_BRANCH(mp)) {
+ MDBX_node *node;
+ int i;
+
+ mdbx_debug("branch page %" PRIaPGNO " has %u keys", mp->mp_pgno,
+ page_numkeys(mp));
+ /* Don't assert on branch pages in the GC. We can get here
+ * while in the process of rebalancing a GC branch page; we must
+ * let that proceed. ITS#8336 */
+ mdbx_cassert(mc, !mc->mc_dbi || page_numkeys(mp) > 1);
+ mdbx_debug("found index 0 to page %" PRIaPGNO, node_pgno(page_node(mp, 0)));
+
+ if (flags & (MDBX_PS_FIRST | MDBX_PS_LAST)) {
+ i = 0;
+ if (flags & MDBX_PS_LAST) {
+ i = page_numkeys(mp) - 1;
+ /* if already init'd, see if we're already in right place */
+ if (mc->mc_flags & C_INITIALIZED) {
+ if (mc->mc_ki[mc->mc_top] == i) {
+ mc->mc_top = mc->mc_snum++;
+ mp = mc->mc_pg[mc->mc_top];
+ goto ready;
+ }
+ }
+ }
+ } else {
+ int exact;
+ node = mdbx_node_search(mc, key, &exact);
+ if (node == NULL)
+ i = page_numkeys(mp) - 1;
+ else {
+ i = mc->mc_ki[mc->mc_top];
+ if (!exact) {
+ mdbx_cassert(mc, i > 0);
+ i--;
+ }
+ }
+ mdbx_debug("following index %u for key [%s]", i, DKEY(key));
+ }
+
+ mdbx_cassert(mc, i < (int)page_numkeys(mp));
+ node = page_node(mp, i);
+
+ if (unlikely((rc = mdbx_page_get(mc, node_pgno(node), &mp, NULL)) != 0))
+ return rc;
+
+ mc->mc_ki[mc->mc_top] = (indx_t)i;
+ if (unlikely(rc = mdbx_cursor_push(mc, mp)))
+ return rc;
+
+ ready:
+ if (flags & MDBX_PS_MODIFY) {
+ if (unlikely((rc = mdbx_page_touch(mc)) != 0))
+ return rc;
+ mp = mc->mc_pg[mc->mc_top];
+ }
+ }
+
+ if (unlikely(!IS_LEAF(mp))) {
+ mdbx_debug("internal error, index points to a page with 0x%02x flags!?",
+ mp->mp_flags);
+ mc->mc_txn->mt_flags |= MDBX_TXN_ERROR;
+ return MDBX_CORRUPTED;
+ }
+
+ mdbx_debug("found leaf page %" PRIaPGNO " for key [%s]", mp->mp_pgno,
+ DKEY(key));
+ mc->mc_flags |= C_INITIALIZED;
+ mc->mc_flags &= ~C_EOF;
+
+ return MDBX_SUCCESS;
+}
+
+static int mdbx_fetch_sdb(MDBX_txn *txn, MDBX_dbi dbi) {
+ MDBX_cursor mc;
+ if (unlikely(TXN_DBI_CHANGED(txn, dbi)))
+ return MDBX_BAD_DBI;
+ int rc = mdbx_cursor_init(&mc, txn, MAIN_DBI);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+ rc = mdbx_page_search(&mc, &txn->mt_dbxs[dbi].md_name, 0);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return (rc == MDBX_NOTFOUND) ? MDBX_BAD_DBI : rc;
+
+ MDBX_val data;
+ int exact = 0;
+ MDBX_node *node = mdbx_node_search(&mc, &txn->mt_dbxs[dbi].md_name, &exact);
+ if (unlikely(!exact))
+ return MDBX_BAD_DBI;
+ if (unlikely((node_flags(node) & (F_DUPDATA | F_SUBDATA)) != F_SUBDATA))
+ return MDBX_INCOMPATIBLE; /* not a named DB */
+ rc = mdbx_node_read(&mc, node, &data);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ if (unlikely(data.iov_len < sizeof(MDBX_db)))
+ return MDBX_INCOMPATIBLE; /* not a named DB */
+
+ uint16_t md_flags = UNALIGNED_PEEK_16(data.iov_base, MDBX_db, md_flags);
+ /* The txn may not know this DBI, or another process may
+ * have dropped and recreated the DB with other flags. */
+ if (unlikely((txn->mt_dbs[dbi].md_flags & PERSISTENT_FLAGS) != md_flags))
+ return MDBX_INCOMPATIBLE;
+
+ memcpy(&txn->mt_dbs[dbi], data.iov_base, sizeof(MDBX_db));
+ txn->mt_dbflags[dbi] &= ~DB_STALE;
+ return MDBX_SUCCESS;
+}
+
+/* Search for the lowest key under the current branch page.
+ * This just bypasses a numkeys check in the current page
+ * before calling mdbx_page_search_root(), because the callers
+ * are all in situations where the current page is known to
+ * be underfilled. */
+__hot static int mdbx_page_search_lowest(MDBX_cursor *mc) {
+ MDBX_page *mp = mc->mc_pg[mc->mc_top];
+ mdbx_cassert(mc, IS_BRANCH(mp));
+ MDBX_node *node = page_node(mp, 0);
+ int rc;
+
+ if (unlikely((rc = mdbx_page_get(mc, node_pgno(node), &mp, NULL)) != 0))
+ return rc;
+
+ mc->mc_ki[mc->mc_top] = 0;
+ if (unlikely(rc = mdbx_cursor_push(mc, mp)))
+ return rc;
+ return mdbx_page_search_root(mc, NULL, MDBX_PS_FIRST);
+}
+
+/* Search for the page a given key should be in.
+ * Push it and its parent pages on the cursor stack.
+ *
+ * [in,out] mc the cursor for this operation.
+ * [in] key the key to search for, or NULL for first/last page.
+ * [in] flags If MDBX_PS_MODIFY is set, visited pages in the DB
+ * are touched (updated with new page numbers).
+ * If MDBX_PS_FIRST or MDBX_PS_LAST is set, find first or last
+ * leaf.
+ * This is used by mdbx_cursor_first() and mdbx_cursor_last().
+ * If MDBX_PS_ROOTONLY set, just fetch root node, no further
+ * lookups.
+ *
+ * Returns 0 on success, non-zero on failure. */
+__hot static int mdbx_page_search(MDBX_cursor *mc, MDBX_val *key, int flags) {
+ int rc;
+ pgno_t root;
+
+ /* Make sure the txn is still viable, then find the root from
+ * the txn's db table and set it as the root of the cursor's stack. */
+ if (unlikely(mc->mc_txn->mt_flags & MDBX_TXN_BLOCKED)) {
+ mdbx_debug("%s", "transaction has failed, must abort");
+ return MDBX_BAD_TXN;
+ }
+
+ /* Make sure we're using an up-to-date root */
+ if (unlikely(*mc->mc_dbflag & DB_STALE)) {
+ rc = mdbx_fetch_sdb(mc->mc_txn, mc->mc_dbi);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+ }
+ root = mc->mc_db->md_root;
+
+ if (unlikely(root == P_INVALID)) { /* Tree is empty. */
+ mdbx_debug("%s", "tree is empty");
+ return MDBX_NOTFOUND;
+ }
+
+ mdbx_cassert(mc, root >= NUM_METAS);
+ if (!mc->mc_pg[0] || mc->mc_pg[0]->mp_pgno != root)
+ if (unlikely((rc = mdbx_page_get(mc, root, &mc->mc_pg[0], NULL)) != 0))
+ return rc;
+
+ mc->mc_snum = 1;
+ mc->mc_top = 0;
+
+ mdbx_debug("db %d root page %" PRIaPGNO " has flags 0x%X", DDBI(mc), root,
+ mc->mc_pg[0]->mp_flags);
+
+ if (flags & MDBX_PS_MODIFY) {
+ if (unlikely(rc = mdbx_page_touch(mc)))
+ return rc;
+ }
+
+ if (flags & MDBX_PS_ROOTONLY)
+ return MDBX_SUCCESS;
+
+ return mdbx_page_search_root(mc, key, flags);
+}
+
+/* Return the data associated with a given node.
+ *
+ * [in] mc The cursor for this operation.
+ * [in] leaf The node being read.
+ * [out] data Updated to point to the node's data.
+ *
+ * Returns 0 on success, non-zero on failure. */
+static __inline int mdbx_node_read(MDBX_cursor *mc, MDBX_node *node,
+ MDBX_val *data) {
+ data->iov_len = node_ds(node);
+ data->iov_base = node_data(node);
+ if (unlikely(F_ISSET(node_flags(node), F_BIGDATA))) {
+ /* Read overflow data. */
+ MDBX_page *omp; /* overflow page */
+ int rc = mdbx_page_get(mc, node_largedata_pgno(node), &omp, NULL);
+ if (unlikely((rc != MDBX_SUCCESS))) {
+ mdbx_debug("read overflow page %" PRIaPGNO " failed",
+ node_largedata_pgno(node));
+ return rc;
+ }
+ data->iov_base = page_data(omp);
+ }
+ return MDBX_SUCCESS;
+}
+
+int mdbx_get(MDBX_txn *txn, MDBX_dbi dbi, MDBX_val *key, MDBX_val *data) {
+ DKBUF;
+ mdbx_debug("===> get db %u key [%s]", dbi, DKEY(key));
+
+ int rc = check_txn(txn, MDBX_TXN_BLOCKED);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ if (unlikely(!key || !data))
+ return MDBX_EINVAL;
+
+ if (unlikely(!TXN_DBI_EXIST(txn, dbi, DB_USRVALID)))
+ return MDBX_EINVAL;
+
+ MDBX_cursor_couple cx;
+ rc = mdbx_cursor_init(&cx.outer, txn, dbi);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ int exact = 0;
+ return mdbx_cursor_set(&cx.outer, key, data, MDBX_SET, &exact);
+}
+
+int mdbx_get_nearest(MDBX_txn *txn, MDBX_dbi dbi, MDBX_val *key,
+ MDBX_val *data) {
+ DKBUF;
+ mdbx_debug("===> get db %u key [%s]", dbi, DKEY(key));
+
+ int rc = check_txn(txn, MDBX_TXN_BLOCKED);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ if (unlikely(!key || !data))
+ return MDBX_EINVAL;
+
+ if (unlikely(!TXN_DBI_EXIST(txn, dbi, DB_USRVALID)))
+ return MDBX_EINVAL;
+
+ if (unlikely(txn->mt_flags & MDBX_TXN_BLOCKED))
+ return MDBX_BAD_TXN;
+
+ MDBX_cursor_couple cx;
+ rc = mdbx_cursor_init(&cx.outer, txn, dbi);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ MDBX_val save_data = *data;
+ int exact = 0;
+ rc = mdbx_cursor_set(&cx.outer, key, data, MDBX_SET_RANGE, &exact);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ if (exact && (txn->mt_dbs[dbi].md_flags & MDBX_DUPSORT) != 0) {
+ *data = save_data;
+ exact = 0;
+ rc = mdbx_cursor_set(&cx.outer, key, data, MDBX_GET_BOTH_RANGE, &exact);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+ }
+
+ return exact ? MDBX_SUCCESS : MDBX_RESULT_TRUE;
+}
+
+int mdbx_get_ex(MDBX_txn *txn, MDBX_dbi dbi, MDBX_val *key, MDBX_val *data,
+ size_t *values_count) {
+ DKBUF;
+ mdbx_debug("===> get db %u key [%s]", dbi, DKEY(key));
+
+ int rc = check_txn(txn, MDBX_TXN_BLOCKED);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ if (unlikely(!key || !data))
+ return MDBX_EINVAL;
+
+ if (unlikely(!TXN_DBI_EXIST(txn, dbi, DB_USRVALID)))
+ return MDBX_EINVAL;
+
+ MDBX_cursor_couple cx;
+ rc = mdbx_cursor_init(&cx.outer, txn, dbi);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ int exact = 0;
+ rc = mdbx_cursor_set(&cx.outer, key, data, MDBX_SET_KEY, &exact);
+ if (unlikely(rc != MDBX_SUCCESS)) {
+ if (rc == MDBX_NOTFOUND && values_count)
+ *values_count = 0;
+ return rc;
+ }
+
+ if (values_count) {
+ *values_count = 1;
+ if (cx.outer.mc_xcursor != NULL) {
+ MDBX_node *node = page_node(cx.outer.mc_pg[cx.outer.mc_top],
+ cx.outer.mc_ki[cx.outer.mc_top]);
+ if (F_ISSET(node_flags(node), F_DUPDATA)) {
+ mdbx_tassert(txn, cx.outer.mc_xcursor == &cx.inner &&
+ (cx.inner.mx_cursor.mc_flags & C_INITIALIZED));
+ *values_count =
+ (sizeof(*values_count) >= sizeof(cx.inner.mx_db.md_entries) ||
+ cx.inner.mx_db.md_entries <= PTRDIFF_MAX)
+ ? (size_t)cx.inner.mx_db.md_entries
+ : PTRDIFF_MAX;
+ }
+ }
+ }
+ return MDBX_SUCCESS;
+}
+
+/* Find a sibling for a page.
+ * Replaces the page at the top of the cursor's stack with the specified
+ * sibling, if one exists.
+ *
+ * [in] mc The cursor for this operation.
+ * [in] move_right Non-zero if the right sibling is requested,
+ * otherwise the left sibling.
+ *
+ * Returns 0 on success, non-zero on failure. */
+static int mdbx_cursor_sibling(MDBX_cursor *mc, int move_right) {
+ int rc;
+ MDBX_node *indx;
+ MDBX_page *mp;
+
+ if (unlikely(mc->mc_snum < 2))
+ return MDBX_NOTFOUND; /* root has no siblings */
+
+ mdbx_cursor_pop(mc);
+ mdbx_debug("parent page is page %" PRIaPGNO ", index %u",
+ mc->mc_pg[mc->mc_top]->mp_pgno, mc->mc_ki[mc->mc_top]);
+
+ if (move_right
+ ? (mc->mc_ki[mc->mc_top] + 1u >= page_numkeys(mc->mc_pg[mc->mc_top]))
+ : (mc->mc_ki[mc->mc_top] == 0)) {
+ mdbx_debug("no more keys left, moving to %s sibling",
+ move_right ? "right" : "left");
+ if (unlikely((rc = mdbx_cursor_sibling(mc, move_right)) != MDBX_SUCCESS)) {
+ /* undo cursor_pop before returning */
+ mc->mc_top++;
+ mc->mc_snum++;
+ return rc;
+ }
+ } else {
+ if (move_right)
+ mc->mc_ki[mc->mc_top]++;
+ else
+ mc->mc_ki[mc->mc_top]--;
+ mdbx_debug("just moving to %s index key %u", move_right ? "right" : "left",
+ mc->mc_ki[mc->mc_top]);
+ }
+ mdbx_cassert(mc, IS_BRANCH(mc->mc_pg[mc->mc_top]));
+
+ indx = page_node(mc->mc_pg[mc->mc_top], mc->mc_ki[mc->mc_top]);
+ if (unlikely((rc = mdbx_page_get(mc, node_pgno(indx), &mp, NULL)) != 0)) {
+ /* mc will be inconsistent if caller does mc_snum++ as above */
+ mc->mc_flags &= ~(C_INITIALIZED | C_EOF);
+ return rc;
+ }
+
+ rc = mdbx_cursor_push(mc, mp);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+ if (!move_right)
+ mc->mc_ki[mc->mc_top] = (indx_t)page_numkeys(mp) - 1;
+
+ return MDBX_SUCCESS;
+}
+
+/* Move the cursor to the next data item. */
+static int mdbx_cursor_next(MDBX_cursor *mc, MDBX_val *key, MDBX_val *data,
+ MDBX_cursor_op op) {
+ MDBX_page *mp;
+ MDBX_node *node;
+ int rc;
+
+ if ((mc->mc_flags & C_DEL) && op == MDBX_NEXT_DUP)
+ return MDBX_NOTFOUND;
+
+ if (!(mc->mc_flags & C_INITIALIZED))
+ return mdbx_cursor_first(mc, key, data);
+
+ mp = mc->mc_pg[mc->mc_top];
+ if (mc->mc_flags & C_EOF) {
+ if (mc->mc_ki[mc->mc_top] + 1u >= page_numkeys(mp))
+ return MDBX_NOTFOUND;
+ mc->mc_flags ^= C_EOF;
+ }
+
+ if (mc->mc_db->md_flags & MDBX_DUPSORT) {
+ node = page_node(mp, mc->mc_ki[mc->mc_top]);
+ if (F_ISSET(node_flags(node), F_DUPDATA)) {
+ if (op == MDBX_NEXT || op == MDBX_NEXT_DUP) {
+ rc =
+ mdbx_cursor_next(&mc->mc_xcursor->mx_cursor, data, NULL, MDBX_NEXT);
+ if (op != MDBX_NEXT || rc != MDBX_NOTFOUND) {
+ if (likely(rc == MDBX_SUCCESS))
+ get_key_optional(node, key);
+ return rc;
+ }
+ }
+ } else {
+ mc->mc_xcursor->mx_cursor.mc_flags &= ~(C_INITIALIZED | C_EOF);
+ if (op == MDBX_NEXT_DUP)
+ return MDBX_NOTFOUND;
+ }
+ }
+
+ mdbx_debug("cursor_next: top page is %" PRIaPGNO " in cursor %p", mp->mp_pgno,
+ (void *)mc);
+ if (mc->mc_flags & C_DEL) {
+ mc->mc_flags ^= C_DEL;
+ goto skip;
+ }
+
+ if (mc->mc_ki[mc->mc_top] + 1u >= page_numkeys(mp)) {
+ mdbx_debug("%s", "=====> move to next sibling page");
+ if (unlikely((rc = mdbx_cursor_sibling(mc, 1)) != MDBX_SUCCESS)) {
+ mc->mc_flags |= C_EOF;
+ return rc;
+ }
+ mp = mc->mc_pg[mc->mc_top];
+ mdbx_debug("next page is %" PRIaPGNO ", key index %u", mp->mp_pgno,
+ mc->mc_ki[mc->mc_top]);
+ } else
+ mc->mc_ki[mc->mc_top]++;
+
+skip:
+ mdbx_debug("==> cursor points to page %" PRIaPGNO
+ " with %u keys, key index %u",
+ mp->mp_pgno, page_numkeys(mp), mc->mc_ki[mc->mc_top]);
+
+ if (IS_LEAF2(mp)) {
+ if (likely(key)) {
+ key->iov_len = mc->mc_db->md_xsize;
+ key->iov_base = page_leaf2key(mp, mc->mc_ki[mc->mc_top], key->iov_len);
+ }
+ return MDBX_SUCCESS;
+ }
+
+ mdbx_cassert(mc, IS_LEAF(mp));
+ node = page_node(mp, mc->mc_ki[mc->mc_top]);
+
+ if (F_ISSET(node_flags(node), F_DUPDATA)) {
+ rc = mdbx_xcursor_init1(mc, node);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+ }
+ if (data) {
+ if (unlikely((rc = mdbx_node_read(mc, node, data)) != MDBX_SUCCESS))
+ return rc;
+
+ if (F_ISSET(node_flags(node), F_DUPDATA)) {
+ rc = mdbx_cursor_first(&mc->mc_xcursor->mx_cursor, data, NULL);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+ }
+ }
+
+ get_key_optional(node, key);
+ return MDBX_SUCCESS;
+}
+
+/* Move the cursor to the previous data item. */
+static int mdbx_cursor_prev(MDBX_cursor *mc, MDBX_val *key, MDBX_val *data,
+ MDBX_cursor_op op) {
+ MDBX_page *mp;
+ MDBX_node *node;
+ int rc;
+
+ if ((mc->mc_flags & C_DEL) && op == MDBX_PREV_DUP)
+ return MDBX_NOTFOUND;
+
+ if (!(mc->mc_flags & C_INITIALIZED)) {
+ rc = mdbx_cursor_last(mc, key, data);
+ if (unlikely(rc))
+ return rc;
+ mc->mc_ki[mc->mc_top]++;
+ }
+
+ mp = mc->mc_pg[mc->mc_top];
+ if ((mc->mc_db->md_flags & MDBX_DUPSORT) &&
+ mc->mc_ki[mc->mc_top] < page_numkeys(mp)) {
+ node = page_node(mp, mc->mc_ki[mc->mc_top]);
+ if (F_ISSET(node_flags(node), F_DUPDATA)) {
+ if (op == MDBX_PREV || op == MDBX_PREV_DUP) {
+ rc =
+ mdbx_cursor_prev(&mc->mc_xcursor->mx_cursor, data, NULL, MDBX_PREV);
+ if (op != MDBX_PREV || rc != MDBX_NOTFOUND) {
+ if (likely(rc == MDBX_SUCCESS)) {
+ get_key_optional(node, key);
+ mc->mc_flags &= ~C_EOF;
+ }
+ return rc;
+ }
+ }
+ } else {
+ mc->mc_xcursor->mx_cursor.mc_flags &= ~(C_INITIALIZED | C_EOF);
+ if (op == MDBX_PREV_DUP)
+ return MDBX_NOTFOUND;
+ }
+ }
+
+ mdbx_debug("cursor_prev: top page is %" PRIaPGNO " in cursor %p", mp->mp_pgno,
+ (void *)mc);
+
+ mc->mc_flags &= ~(C_EOF | C_DEL);
+
+ if (mc->mc_ki[mc->mc_top] == 0) {
+ mdbx_debug("%s", "=====> move to prev sibling page");
+ if ((rc = mdbx_cursor_sibling(mc, 0)) != MDBX_SUCCESS) {
+ return rc;
+ }
+ mp = mc->mc_pg[mc->mc_top];
+ mc->mc_ki[mc->mc_top] = (indx_t)page_numkeys(mp) - 1;
+ mdbx_debug("prev page is %" PRIaPGNO ", key index %u", mp->mp_pgno,
+ mc->mc_ki[mc->mc_top]);
+ } else
+ mc->mc_ki[mc->mc_top]--;
+
+ mdbx_debug("==> cursor points to page %" PRIaPGNO
+ " with %u keys, key index %u",
+ mp->mp_pgno, page_numkeys(mp), mc->mc_ki[mc->mc_top]);
+
+ if (IS_LEAF2(mp)) {
+ if (likely(key)) {
+ key->iov_len = mc->mc_db->md_xsize;
+ key->iov_base = page_leaf2key(mp, mc->mc_ki[mc->mc_top], key->iov_len);
+ }
+ return MDBX_SUCCESS;
+ }
+
+ mdbx_cassert(mc, IS_LEAF(mp));
+ node = page_node(mp, mc->mc_ki[mc->mc_top]);
+
+ if (F_ISSET(node_flags(node), F_DUPDATA)) {
+ rc = mdbx_xcursor_init1(mc, node);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+ }
+ if (data) {
+ if (unlikely((rc = mdbx_node_read(mc, node, data)) != MDBX_SUCCESS))
+ return rc;
+
+ if (F_ISSET(node_flags(node), F_DUPDATA)) {
+ rc = mdbx_cursor_last(&mc->mc_xcursor->mx_cursor, data, NULL);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+ }
+ }
+
+ get_key_optional(node, key);
+ return MDBX_SUCCESS;
+}
+
+/* Set the cursor on a specific data item. */
+__hot static int mdbx_cursor_set(MDBX_cursor *mc, MDBX_val *key, MDBX_val *data,
+ MDBX_cursor_op op, int *exactp) {
+ int rc;
+ MDBX_page *mp;
+ MDBX_node *node = NULL;
+ DKBUF;
+
+ if ((mc->mc_db->md_flags & MDBX_INTEGERKEY) &&
+ unlikely(key->iov_len != sizeof(uint32_t) &&
+ key->iov_len != sizeof(uint64_t))) {
+ mdbx_cassert(mc, !"key-size is invalid for MDBX_INTEGERKEY");
+ return MDBX_BAD_VALSIZE;
+ }
+
+ if (mc->mc_xcursor)
+ mc->mc_xcursor->mx_cursor.mc_flags &= ~(C_INITIALIZED | C_EOF);
+
+ /* See if we're already on the right page */
+ if (mc->mc_flags & C_INITIALIZED) {
+ MDBX_val nodekey;
+
+ mdbx_cassert(mc, IS_LEAF(mc->mc_pg[mc->mc_top]));
+ mp = mc->mc_pg[mc->mc_top];
+ if (!page_numkeys(mp)) {
+ mc->mc_ki[mc->mc_top] = 0;
+ return MDBX_NOTFOUND;
+ }
+ if (IS_LEAF2(mp)) {
+ nodekey.iov_len = mc->mc_db->md_xsize;
+ nodekey.iov_base = page_leaf2key(mp, 0, nodekey.iov_len);
+ } else {
+ node = page_node(mp, 0);
+ get_key(node, &nodekey);
+ }
+ rc = mc->mc_dbx->md_cmp(key, &nodekey);
+ if (unlikely(rc == 0)) {
+ /* Probably happens rarely, but first node on the page
+ * was the one we wanted. */
+ mc->mc_ki[mc->mc_top] = 0;
+ if (exactp)
+ *exactp = 1;
+ goto set1;
+ }
+ if (rc > 0) {
+ const unsigned nkeys = page_numkeys(mp);
+ unsigned i;
+ if (nkeys > 1) {
+ if (IS_LEAF2(mp)) {
+ nodekey.iov_base = page_leaf2key(mp, nkeys - 1, nodekey.iov_len);
+ } else {
+ node = page_node(mp, nkeys - 1);
+ get_key(node, &nodekey);
+ }
+ rc = mc->mc_dbx->md_cmp(key, &nodekey);
+ if (rc == 0) {
+ /* last node was the one we wanted */
+ mdbx_cassert(mc, nkeys >= 1 && nkeys <= UINT16_MAX + 1);
+ mc->mc_ki[mc->mc_top] = (indx_t)(nkeys - 1);
+ if (exactp)
+ *exactp = 1;
+ goto set1;
+ }
+ if (rc < 0) {
+ if (mc->mc_ki[mc->mc_top] < page_numkeys(mp)) {
+ /* This is definitely the right page, skip search_page */
+ if (IS_LEAF2(mp)) {
+ nodekey.iov_base =
+ page_leaf2key(mp, mc->mc_ki[mc->mc_top], nodekey.iov_len);
+ } else {
+ node = page_node(mp, mc->mc_ki[mc->mc_top]);
+ get_key(node, &nodekey);
+ }
+ rc = mc->mc_dbx->md_cmp(key, &nodekey);
+ if (rc == 0) {
+ /* current node was the one we wanted */
+ if (exactp)
+ *exactp = 1;
+ goto set1;
+ }
+ }
+ rc = 0;
+ mc->mc_flags &= ~C_EOF;
+ goto set2;
+ }
+ }
+ /* If any parents have right-sibs, search.
+ * Otherwise, there's nothing further. */
+ for (i = 0; i < mc->mc_top; i++)
+ if (mc->mc_ki[i] < page_numkeys(mc->mc_pg[i]) - 1)
+ break;
+ if (i == mc->mc_top) {
+ /* There are no other pages */
+ mdbx_cassert(mc, nkeys <= UINT16_MAX);
+ mc->mc_ki[mc->mc_top] = (uint16_t)nkeys;
+ return MDBX_NOTFOUND;
+ }
+ }
+ if (!mc->mc_top) {
+ /* There are no other pages */
+ mc->mc_ki[mc->mc_top] = 0;
+ if (op == MDBX_SET_RANGE && !exactp) {
+ rc = 0;
+ goto set1;
+ } else
+ return MDBX_NOTFOUND;
+ }
+ } else {
+ mc->mc_pg[0] = 0;
+ }
+
+ rc = mdbx_page_search(mc, key, 0);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ mp = mc->mc_pg[mc->mc_top];
+ mdbx_cassert(mc, IS_LEAF(mp));
+
+set2:
+ node = mdbx_node_search(mc, key, exactp);
+ if (exactp != NULL && !*exactp) {
+ /* MDBX_SET specified and not an exact match. */
+ return MDBX_NOTFOUND;
+ }
+
+ if (node == NULL) {
+ mdbx_debug("%s", "===> inexact leaf not found, goto sibling");
+ if (unlikely((rc = mdbx_cursor_sibling(mc, 1)) != MDBX_SUCCESS)) {
+ mc->mc_flags |= C_EOF;
+ return rc; /* no entries matched */
+ }
+ mp = mc->mc_pg[mc->mc_top];
+ mdbx_cassert(mc, IS_LEAF(mp));
+ node = page_node(mp, 0);
+ }
+
+set1:
+ mc->mc_flags |= C_INITIALIZED;
+ mc->mc_flags &= ~C_EOF;
+
+ if (IS_LEAF2(mp)) {
+ if (op == MDBX_SET_RANGE || op == MDBX_SET_KEY) {
+ key->iov_len = mc->mc_db->md_xsize;
+ key->iov_base = page_leaf2key(mp, mc->mc_ki[mc->mc_top], key->iov_len);
+ }
+ return MDBX_SUCCESS;
+ }
+
+ if (F_ISSET(node_flags(node), F_DUPDATA)) {
+ rc = mdbx_xcursor_init1(mc, node);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+ }
+ if (likely(data)) {
+ if (F_ISSET(node_flags(node), F_DUPDATA)) {
+ if (op == MDBX_SET || op == MDBX_SET_KEY || op == MDBX_SET_RANGE) {
+ rc = mdbx_cursor_first(&mc->mc_xcursor->mx_cursor, data, NULL);
+ } else {
+ int ex2, *ex2p;
+ if (op == MDBX_GET_BOTH) {
+ ex2p = &ex2;
+ ex2 = 0;
+ } else {
+ ex2p = NULL;
+ }
+ rc = mdbx_cursor_set(&mc->mc_xcursor->mx_cursor, data, NULL,
+ MDBX_SET_RANGE, ex2p);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+ }
+ } else if (op == MDBX_GET_BOTH || op == MDBX_GET_BOTH_RANGE) {
+ MDBX_val olddata;
+ if (unlikely((rc = mdbx_node_read(mc, node, &olddata)) != MDBX_SUCCESS))
+ return rc;
+ if (unlikely(mc->mc_dbx->md_dcmp == NULL))
+ return MDBX_EINVAL;
+ rc = mc->mc_dbx->md_dcmp(data, &olddata);
+ if (rc) {
+ if (op != MDBX_GET_BOTH_RANGE || rc > 0)
+ return MDBX_NOTFOUND;
+ rc = 0;
+ }
+ *data = olddata;
+ } else {
+ if (mc->mc_xcursor)
+ mc->mc_xcursor->mx_cursor.mc_flags &= ~(C_INITIALIZED | C_EOF);
+ if (unlikely((rc = mdbx_node_read(mc, node, data)) != MDBX_SUCCESS))
+ return rc;
+ }
+ }
+
+ /* The key already matches in all other cases */
+ if (op == MDBX_SET_RANGE || op == MDBX_SET_KEY)
+ get_key_optional(node, key);
+
+ mdbx_debug("==> cursor placed on key [%s], data [%s]", DKEY(key), DVAL(data));
+ return rc;
+}
+
+/* Move the cursor to the first item in the database. */
+static int mdbx_cursor_first(MDBX_cursor *mc, MDBX_val *key, MDBX_val *data) {
+ int rc;
+
+ if (mc->mc_xcursor)
+ mc->mc_xcursor->mx_cursor.mc_flags &= ~(C_INITIALIZED | C_EOF);
+
+ if (!(mc->mc_flags & C_INITIALIZED) || mc->mc_top) {
+ rc = mdbx_page_search(mc, NULL, MDBX_PS_FIRST);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+ }
+ mdbx_cassert(mc, IS_LEAF(mc->mc_pg[mc->mc_top]));
+
+ mc->mc_flags |= C_INITIALIZED;
+ mc->mc_flags &= ~C_EOF;
+ mc->mc_ki[mc->mc_top] = 0;
+
+ if (IS_LEAF2(mc->mc_pg[mc->mc_top])) {
+ key->iov_len = mc->mc_db->md_xsize;
+ key->iov_base = page_leaf2key(mc->mc_pg[mc->mc_top], 0, key->iov_len);
+ return MDBX_SUCCESS;
+ }
+
+ MDBX_node *node = page_node(mc->mc_pg[mc->mc_top], 0);
+ if (likely(data)) {
+ if (F_ISSET(node_flags(node), F_DUPDATA)) {
+ rc = mdbx_xcursor_init1(mc, node);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+ rc = mdbx_cursor_first(&mc->mc_xcursor->mx_cursor, data, NULL);
+ if (unlikely(rc))
+ return rc;
+ } else {
+ if (unlikely((rc = mdbx_node_read(mc, node, data)) != MDBX_SUCCESS))
+ return rc;
+ }
+ }
+ get_key_optional(node, key);
+ return MDBX_SUCCESS;
+}
+
+/* Move the cursor to the last item in the database. */
+static int mdbx_cursor_last(MDBX_cursor *mc, MDBX_val *key, MDBX_val *data) {
+ int rc;
+
+ if (mc->mc_xcursor)
+ mc->mc_xcursor->mx_cursor.mc_flags &= ~(C_INITIALIZED | C_EOF);
+
+ if (likely((mc->mc_flags & (C_EOF | C_DEL)) != C_EOF)) {
+ if (!(mc->mc_flags & C_INITIALIZED) || mc->mc_top) {
+ rc = mdbx_page_search(mc, NULL, MDBX_PS_LAST);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+ }
+ mdbx_cassert(mc, IS_LEAF(mc->mc_pg[mc->mc_top]));
+ }
+
+ mc->mc_ki[mc->mc_top] = (indx_t)page_numkeys(mc->mc_pg[mc->mc_top]) - 1;
+ mc->mc_flags |= C_INITIALIZED | C_EOF;
+
+ if (IS_LEAF2(mc->mc_pg[mc->mc_top])) {
+ key->iov_len = mc->mc_db->md_xsize;
+ key->iov_base = page_leaf2key(mc->mc_pg[mc->mc_top], mc->mc_ki[mc->mc_top],
+ key->iov_len);
+ return MDBX_SUCCESS;
+ }
+
+ MDBX_node *node = page_node(mc->mc_pg[mc->mc_top], mc->mc_ki[mc->mc_top]);
+ if (likely(data)) {
+ if (F_ISSET(node_flags(node), F_DUPDATA)) {
+ rc = mdbx_xcursor_init1(mc, node);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+ rc = mdbx_cursor_last(&mc->mc_xcursor->mx_cursor, data, NULL);
+ if (unlikely(rc))
+ return rc;
+ } else {
+ if (unlikely((rc = mdbx_node_read(mc, node, data)) != MDBX_SUCCESS))
+ return rc;
+ }
+ }
+
+ get_key_optional(node, key);
+ return MDBX_SUCCESS;
+}
+
+int mdbx_cursor_get(MDBX_cursor *mc, MDBX_val *key, MDBX_val *data,
+ MDBX_cursor_op op) {
+ if (unlikely(mc == NULL))
+ return MDBX_EINVAL;
+
+ if (unlikely(mc->mc_signature != MDBX_MC_SIGNATURE))
+ return MDBX_EBADSIGN;
+
+ int rc = check_txn(mc->mc_txn, MDBX_TXN_BLOCKED);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ int exact = 0;
+ int (*mfunc)(MDBX_cursor * mc, MDBX_val * key, MDBX_val * data);
+ switch (op) {
+ case MDBX_GET_CURRENT: {
+ if (unlikely(!(mc->mc_flags & C_INITIALIZED)))
+ return MDBX_EINVAL;
+ MDBX_page *mp = mc->mc_pg[mc->mc_top];
+ const unsigned nkeys = page_numkeys(mp);
+ if (mc->mc_ki[mc->mc_top] >= nkeys) {
+ mdbx_cassert(mc, nkeys <= UINT16_MAX);
+ mc->mc_ki[mc->mc_top] = (uint16_t)nkeys;
+ return MDBX_NOTFOUND;
+ }
+ mdbx_cassert(mc, nkeys > 0);
+
+ rc = MDBX_SUCCESS;
+ if (IS_LEAF2(mp)) {
+ key->iov_len = mc->mc_db->md_xsize;
+ key->iov_base = page_leaf2key(mp, mc->mc_ki[mc->mc_top], key->iov_len);
+ } else {
+ MDBX_node *node = page_node(mp, mc->mc_ki[mc->mc_top]);
+ get_key_optional(node, key);
+ if (data) {
+ if (F_ISSET(node_flags(node), F_DUPDATA)) {
+ if (unlikely(!(mc->mc_xcursor->mx_cursor.mc_flags & C_INITIALIZED))) {
+ rc = mdbx_xcursor_init1(mc, node);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+ rc = mdbx_cursor_first(&mc->mc_xcursor->mx_cursor, data, NULL);
+ if (unlikely(rc))
+ return rc;
+ }
+ rc = mdbx_cursor_get(&mc->mc_xcursor->mx_cursor, data, NULL,
+ MDBX_GET_CURRENT);
+ } else {
+ rc = mdbx_node_read(mc, node, data);
+ }
+ if (unlikely(rc))
+ return rc;
+ }
+ }
+ break;
+ }
+ case MDBX_GET_BOTH:
+ case MDBX_GET_BOTH_RANGE:
+ if (unlikely(data == NULL))
+ return MDBX_EINVAL;
+ if (unlikely(mc->mc_xcursor == NULL))
+ return MDBX_INCOMPATIBLE;
+ /* fall through */
+ __fallthrough;
+ case MDBX_SET:
+ case MDBX_SET_KEY:
+ case MDBX_SET_RANGE:
+ if (unlikely(key == NULL))
+ return MDBX_EINVAL;
+ rc = mdbx_cursor_set(mc, key, data, op,
+ op == MDBX_SET_RANGE ? NULL : &exact);
+ break;
+ case MDBX_GET_MULTIPLE:
+ if (unlikely(data == NULL || !(mc->mc_flags & C_INITIALIZED)))
+ return MDBX_EINVAL;
+ if (unlikely(!(mc->mc_db->md_flags & MDBX_DUPFIXED)))
+ return MDBX_INCOMPATIBLE;
+ rc = MDBX_SUCCESS;
+ if (!(mc->mc_xcursor->mx_cursor.mc_flags & C_INITIALIZED) ||
+ (mc->mc_xcursor->mx_cursor.mc_flags & C_EOF))
+ break;
+ goto fetchm;
+ case MDBX_NEXT_MULTIPLE:
+ if (unlikely(data == NULL))
+ return MDBX_EINVAL;
+ if (unlikely(!(mc->mc_db->md_flags & MDBX_DUPFIXED)))
+ return MDBX_INCOMPATIBLE;
+ rc = mdbx_cursor_next(mc, key, data, MDBX_NEXT_DUP);
+ if (rc == MDBX_SUCCESS) {
+ if (mc->mc_xcursor->mx_cursor.mc_flags & C_INITIALIZED) {
+ MDBX_cursor *mx;
+ fetchm:
+ mx = &mc->mc_xcursor->mx_cursor;
+ data->iov_len =
+ page_numkeys(mx->mc_pg[mx->mc_top]) * mx->mc_db->md_xsize;
+ data->iov_base = page_data(mx->mc_pg[mx->mc_top]);
+ mx->mc_ki[mx->mc_top] = (indx_t)page_numkeys(mx->mc_pg[mx->mc_top]) - 1;
+ } else {
+ rc = MDBX_NOTFOUND;
+ }
+ }
+ break;
+ case MDBX_PREV_MULTIPLE:
+ if (data == NULL)
+ return MDBX_EINVAL;
+ if (!(mc->mc_db->md_flags & MDBX_DUPFIXED))
+ return MDBX_INCOMPATIBLE;
+ rc = MDBX_SUCCESS;
+ if (!(mc->mc_flags & C_INITIALIZED))
+ rc = mdbx_cursor_last(mc, key, data);
+ if (rc == MDBX_SUCCESS) {
+ MDBX_cursor *mx = &mc->mc_xcursor->mx_cursor;
+ if (mx->mc_flags & C_INITIALIZED) {
+ rc = mdbx_cursor_sibling(mx, 0);
+ if (rc == MDBX_SUCCESS)
+ goto fetchm;
+ } else {
+ rc = MDBX_NOTFOUND;
+ }
+ }
+ break;
+ case MDBX_NEXT:
+ case MDBX_NEXT_DUP:
+ case MDBX_NEXT_NODUP:
+ rc = mdbx_cursor_next(mc, key, data, op);
+ break;
+ case MDBX_PREV:
+ case MDBX_PREV_DUP:
+ case MDBX_PREV_NODUP:
+ rc = mdbx_cursor_prev(mc, key, data, op);
+ break;
+ case MDBX_FIRST:
+ rc = mdbx_cursor_first(mc, key, data);
+ break;
+ case MDBX_FIRST_DUP:
+ mfunc = mdbx_cursor_first;
+ mmove:
+ if (unlikely(data == NULL || !(mc->mc_flags & C_INITIALIZED)))
+ return MDBX_EINVAL;
+ if (unlikely(mc->mc_xcursor == NULL))
+ return MDBX_INCOMPATIBLE;
+ if (mc->mc_ki[mc->mc_top] >= page_numkeys(mc->mc_pg[mc->mc_top])) {
+ mc->mc_ki[mc->mc_top] = (indx_t)page_numkeys(mc->mc_pg[mc->mc_top]);
+ return MDBX_NOTFOUND;
+ }
+ {
+ MDBX_node *node = page_node(mc->mc_pg[mc->mc_top], mc->mc_ki[mc->mc_top]);
+ if (!F_ISSET(node_flags(node), F_DUPDATA)) {
+ get_key_optional(node, key);
+ rc = mdbx_node_read(mc, node, data);
+ break;
+ }
+ }
+ if (unlikely(!(mc->mc_xcursor->mx_cursor.mc_flags & C_INITIALIZED)))
+ return MDBX_EINVAL;
+ rc = mfunc(&mc->mc_xcursor->mx_cursor, data, NULL);
+ break;
+ case MDBX_LAST:
+ rc = mdbx_cursor_last(mc, key, data);
+ break;
+ case MDBX_LAST_DUP:
+ mfunc = mdbx_cursor_last;
+ goto mmove;
+ default:
+ mdbx_debug("unhandled/unimplemented cursor operation %u", op);
+ return MDBX_EINVAL;
+ }
+
+ mc->mc_flags &= ~C_DEL;
+ return rc;
+}
+
+/* Touch all the pages in the cursor stack. Set mc_top.
+ * Makes sure all the pages are writable, before attempting a write operation.
+ * [in] mc The cursor to operate on. */
+static int mdbx_cursor_touch(MDBX_cursor *mc) {
+ int rc = MDBX_SUCCESS;
+
+ if (mc->mc_dbi >= CORE_DBS &&
+ (*mc->mc_dbflag & (DB_DIRTY | DB_DUPDATA)) == 0) {
+ mdbx_cassert(mc, (mc->mc_flags & C_RECLAIMING) == 0);
+ /* Touch DB record of named DB */
+ MDBX_cursor_couple cx;
+ if (TXN_DBI_CHANGED(mc->mc_txn, mc->mc_dbi))
+ return MDBX_BAD_DBI;
+ rc = mdbx_cursor_init(&cx.outer, mc->mc_txn, MAIN_DBI);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+ rc = mdbx_page_search(&cx.outer, &mc->mc_dbx->md_name, MDBX_PS_MODIFY);
+ if (unlikely(rc))
+ return rc;
+ *mc->mc_dbflag |= DB_DIRTY;
+ }
+ mc->mc_top = 0;
+ if (mc->mc_snum) {
+ do {
+ rc = mdbx_page_touch(mc);
+ } while (!rc && ++(mc->mc_top) < mc->mc_snum);
+ mc->mc_top = mc->mc_snum - 1;
+ }
+ return rc;
+}
+
+int mdbx_cursor_put(MDBX_cursor *mc, MDBX_val *key, MDBX_val *data,
+ unsigned flags) {
+ MDBX_env *env;
+ MDBX_page *fp, *sub_root = NULL;
+ uint16_t fp_flags;
+ MDBX_val xdata, *rdata, dkey, olddata;
+ MDBX_db nested_dupdb;
+ unsigned mcount = 0, dcount = 0, nospill;
+ size_t nsize;
+ int rc2;
+ unsigned nflags;
+ DKBUF;
+
+ if (unlikely(mc == NULL || key == NULL))
+ return MDBX_EINVAL;
+
+ if (unlikely(mc->mc_signature != MDBX_MC_SIGNATURE))
+ return MDBX_EBADSIGN;
+
+ int rc = check_txn_rw(mc->mc_txn, MDBX_TXN_BLOCKED);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ env = mc->mc_txn->mt_env;
+
+ /* Check this first so counter will always be zero on any early failures. */
+ if (flags & MDBX_MULTIPLE) {
+ if (unlikely(!F_ISSET(mc->mc_db->md_flags, MDBX_DUPFIXED)))
+ return MDBX_INCOMPATIBLE;
+ if (unlikely(data[1].iov_len >= INT_MAX))
+ return MDBX_EINVAL;
+ dcount = (unsigned)data[1].iov_len;
+ data[1].iov_len = 0;
+ }
+
+ if (flags & MDBX_RESERVE) {
+ if (unlikely(mc->mc_db->md_flags & (MDBX_DUPSORT | MDBX_REVERSEDUP)))
+ return MDBX_INCOMPATIBLE;
+ data->iov_base = nullptr;
+ }
+
+ nospill = flags & MDBX_NOSPILL;
+ flags &= ~MDBX_NOSPILL;
+
+ if (unlikely(mc->mc_txn->mt_flags & (MDBX_RDONLY | MDBX_TXN_BLOCKED)))
+ return (mc->mc_txn->mt_flags & MDBX_RDONLY) ? MDBX_EACCESS : MDBX_BAD_TXN;
+
+ if (unlikely(key->iov_len > env->me_maxkey_limit))
+ return MDBX_BAD_VALSIZE;
+
+ if (unlikely(data->iov_len > ((mc->mc_db->md_flags & MDBX_DUPSORT)
+ ? env->me_maxkey_limit
+ : MDBX_MAXDATASIZE)))
+ return MDBX_BAD_VALSIZE;
+
+ if ((mc->mc_db->md_flags & MDBX_INTEGERKEY) &&
+ unlikely(key->iov_len != sizeof(uint32_t) &&
+ key->iov_len != sizeof(uint64_t))) {
+ mdbx_cassert(mc, !"key-size is invalid for MDBX_INTEGERKEY");
+ return MDBX_BAD_VALSIZE;
+ }
+
+ if ((mc->mc_db->md_flags & MDBX_INTEGERDUP) &&
+ unlikely(data->iov_len != sizeof(uint32_t) &&
+ data->iov_len != sizeof(uint64_t))) {
+ mdbx_cassert(mc, !"data-size is invalid MDBX_INTEGERDUP");
+ return MDBX_BAD_VALSIZE;
+ }
+
+ mdbx_debug("==> put db %d key [%s], size %" PRIuPTR
+ ", data [%s] size %" PRIuPTR,
+ DDBI(mc), DKEY(key), key ? key->iov_len : 0,
+ DVAL((flags & MDBX_RESERVE) ? nullptr : data), data->iov_len);
+
+ int dupdata_flag = 0;
+ if ((flags & MDBX_CURRENT) != 0 && (mc->mc_flags & C_SUB) == 0) {
+ /* Опция MDBX_CURRENT означает, что запрошено обновление текущей записи,
+ * на которой сейчас стоит курсор. Проверяем что переданный ключ совпадает
+ * со значением в текущей позиции курсора.
+ * Здесь проще вызвать mdbx_cursor_get(), так как для обслуживания таблиц
+ * с MDBX_DUPSORT также требуется текущий размер данных. */
+ MDBX_val current_key, current_data;
+ rc = mdbx_cursor_get(mc, ¤t_key, ¤t_data, MDBX_GET_CURRENT);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+ if (mc->mc_dbx->md_cmp(key, ¤t_key) != 0)
+ return MDBX_EKEYMISMATCH;
+
+ if (F_ISSET(mc->mc_db->md_flags, MDBX_DUPSORT)) {
+ MDBX_node *node = page_node(mc->mc_pg[mc->mc_top], mc->mc_ki[mc->mc_top]);
+ if (F_ISSET(node_flags(node), F_DUPDATA)) {
+ mdbx_cassert(mc,
+ mc->mc_xcursor != NULL &&
+ (mc->mc_xcursor->mx_cursor.mc_flags & C_INITIALIZED));
+ /* Если за ключом более одного значения, либо если размер данных
+ * отличается, то вместо inplace обновления требуется удаление и
+ * последующая вставка. */
+ if (mc->mc_xcursor->mx_db.md_entries > 1 ||
+ current_data.iov_len != data->iov_len) {
+ rc = mdbx_cursor_del(mc, 0);
+ if (rc != MDBX_SUCCESS)
+ return rc;
+ flags -= MDBX_CURRENT;
+ }
+ } else if (unlikely(node_size(key, data) > env->me_nodemax)) {
+ rc = mdbx_cursor_del(mc, 0);
+ if (rc != MDBX_SUCCESS)
+ return rc;
+ flags -= MDBX_CURRENT;
+ }
+ }
+ }
+
+ if (mc->mc_db->md_root == P_INVALID) {
+ /* new database, cursor has nothing to point to */
+ mc->mc_snum = 0;
+ mc->mc_top = 0;
+ mc->mc_flags &= ~C_INITIALIZED;
+ rc = MDBX_NO_ROOT;
+ } else if ((flags & MDBX_CURRENT) == 0) {
+ int exact = 0;
+ MDBX_val d2;
+ if (flags & MDBX_APPEND) {
+ MDBX_val k2;
+ rc = mdbx_cursor_last(mc, &k2, &d2);
+ if (rc == 0) {
+ rc = mc->mc_dbx->md_cmp(key, &k2);
+ if (rc > 0) {
+ rc = MDBX_NOTFOUND;
+ mc->mc_ki[mc->mc_top]++;
+ } else if (unlikely(rc < 0 || (flags & MDBX_APPENDDUP) == 0)) {
+ /* new key is <= last key */
+ rc = MDBX_EKEYMISMATCH;
+ }
+ }
+ } else {
+ rc = mdbx_cursor_set(mc, key, &d2, MDBX_SET, &exact);
+ }
+ if ((flags & MDBX_NOOVERWRITE) &&
+ (rc == MDBX_SUCCESS || rc == MDBX_EKEYMISMATCH)) {
+ mdbx_debug("duplicate key [%s]", DKEY(key));
+ *data = d2;
+ return MDBX_KEYEXIST;
+ }
+ if (rc && unlikely(rc != MDBX_NOTFOUND))
+ return rc;
+ }
+
+ mc->mc_flags &= ~C_DEL;
+
+ /* Cursor is positioned, check for room in the dirty list */
+ if (!nospill) {
+ if (flags & MDBX_MULTIPLE) {
+ rdata = &xdata;
+ xdata.iov_len = data->iov_len * dcount;
+ } else {
+ rdata = data;
+ }
+ if (unlikely(rc2 = mdbx_page_spill(mc, key, rdata)))
+ return rc2;
+ }
+
+ if (rc == MDBX_NO_ROOT) {
+ MDBX_page *np;
+ /* new database, write a root leaf page */
+ mdbx_debug("%s", "allocating new root leaf page");
+ if (unlikely(rc2 = mdbx_page_new(mc, P_LEAF, 1, &np))) {
+ return rc2;
+ }
+ rc2 = mdbx_cursor_push(mc, np);
+ if (unlikely(rc2 != MDBX_SUCCESS))
+ return rc2;
+ mc->mc_db->md_root = np->mp_pgno;
+ mc->mc_db->md_depth++;
+ *mc->mc_dbflag |= DB_DIRTY;
+ if ((mc->mc_db->md_flags & (MDBX_DUPSORT | MDBX_DUPFIXED)) == MDBX_DUPFIXED)
+ np->mp_flags |= P_LEAF2;
+ mc->mc_flags |= C_INITIALIZED;
+ } else {
+ /* make sure all cursor pages are writable */
+ rc2 = mdbx_cursor_touch(mc);
+ if (unlikely(rc2))
+ return rc2;
+ }
+
+ bool insert_key, insert_data, do_sub = false;
+ insert_key = insert_data = (rc != MDBX_SUCCESS);
+ if (insert_key) {
+ /* The key does not exist */
+ mdbx_debug("inserting key at index %i", mc->mc_ki[mc->mc_top]);
+ if ((mc->mc_db->md_flags & MDBX_DUPSORT) &&
+ node_size(key, data) > env->me_nodemax) {
+ /* Too big for a node, insert in sub-DB. Set up an empty
+ * "old sub-page" for prep_subDB to expand to a full page. */
+ fp_flags = P_LEAF | P_DIRTY;
+ fp = env->me_pbuf;
+ fp->mp_leaf2_ksize = (uint16_t)data->iov_len; /* used if MDBX_DUPFIXED */
+ fp->mp_lower = fp->mp_upper = 0;
+ olddata.iov_len = PAGEHDRSZ;
+ goto prep_subDB;
+ }
+ } else {
+ /* there's only a key anyway, so this is a no-op */
+ if (IS_LEAF2(mc->mc_pg[mc->mc_top])) {
+ char *ptr;
+ unsigned ksize = mc->mc_db->md_xsize;
+ if (key->iov_len != ksize)
+ return MDBX_BAD_VALSIZE;
+ ptr = page_leaf2key(mc->mc_pg[mc->mc_top], mc->mc_ki[mc->mc_top], ksize);
+ memcpy(ptr, key->iov_base, ksize);
+ fix_parent:
+ /* if overwriting slot 0 of leaf, need to
+ * update branch key if there is a parent page */
+ if (mc->mc_top && !mc->mc_ki[mc->mc_top]) {
+ unsigned dtop = 1;
+ mc->mc_top--;
+ /* slot 0 is always an empty key, find real slot */
+ while (mc->mc_top && !mc->mc_ki[mc->mc_top]) {
+ mc->mc_top--;
+ dtop++;
+ }
+ if (mc->mc_ki[mc->mc_top])
+ rc2 = mdbx_update_key(mc, key);
+ else
+ rc2 = MDBX_SUCCESS;
+ mdbx_cassert(mc, mc->mc_top + dtop < UINT16_MAX);
+ mc->mc_top += (uint16_t)dtop;
+ if (rc2)
+ return rc2;
+ }
+
+ if (mdbx_audit_enabled()) {
+ int err = mdbx_cursor_check(mc, false);
+ if (unlikely(err != MDBX_SUCCESS))
+ return err;
+ }
+ return MDBX_SUCCESS;
+ }
+
+ more:;
+ if (mdbx_audit_enabled()) {
+ int err = mdbx_cursor_check(mc, false);
+ if (unlikely(err != MDBX_SUCCESS))
+ return err;
+ }
+ MDBX_node *node = page_node(mc->mc_pg[mc->mc_top], mc->mc_ki[mc->mc_top]);
+
+ /* overflow page overwrites need special handling */
+ if (unlikely(F_ISSET(node_flags(node), F_BIGDATA))) {
+ int level, ovpages,
+ dpages = (node_size(key, data) > env->me_nodemax)
+ ? number_of_ovpages(env, data->iov_len)
+ : 0;
+
+ const pgno_t pg = node_largedata_pgno(node);
+ MDBX_page *omp;
+ if (unlikely((rc2 = mdbx_page_get(mc, pg, &omp, &level)) != 0))
+ return rc2;
+ ovpages = omp->mp_pages;
+
+ /* Is the ov page large enough? */
+ if (unlikely(mc->mc_flags & C_GCFREEZE)
+ ? ovpages >= dpages
+ : ovpages ==
+ /* LY: add configurable threshold to keep reserve space */
+ dpages) {
+ if (!IS_DIRTY(omp) && (level || (env->me_flags & MDBX_WRITEMAP))) {
+ rc = mdbx_page_unspill(mc->mc_txn, omp, &omp);
+ if (unlikely(rc))
+ return rc;
+ level = 0; /* dirty in this txn or clean */
+ }
+ /* Is it dirty? */
+ if (IS_DIRTY(omp)) {
+ /* yes, overwrite it. Note in this case we don't
+ * bother to try shrinking the page if the new data
+ * is smaller than the overflow threshold. */
+ if (unlikely(level > 1)) {
+ /* It is writable only in a parent txn */
+ MDBX_page *np = mdbx_page_malloc(mc->mc_txn, ovpages);
+ if (unlikely(!np))
+ return MDBX_ENOMEM;
+ /* Note - this page is already counted in parent's dirtyroom */
+ rc2 = mdbx_dpl_append(mc->mc_txn->tw.dirtylist, pg, np);
+ if (unlikely(rc2 != MDBX_SUCCESS)) {
+ rc = rc2;
+ mdbx_dpage_free(env, np, ovpages);
+ goto fail;
+ }
+
+ /* Currently we make the page look as with put() in the
+ * parent txn, in case the user peeks at MDBX_RESERVEd
+ * or unused parts. Some users treat ovpages specially. */
+ const size_t whole = pgno2bytes(env, ovpages);
+ /* Skip the part where MDBX will put *data.
+ * Copy end of page, adjusting alignment so
+ * compiler may copy words instead of bytes. */
+ const size_t off =
+ (PAGEHDRSZ + data->iov_len) & -(intptr_t)sizeof(size_t);
+ memcpy((size_t *)((char *)np + off), (size_t *)((char *)omp + off),
+ whole - off);
+ memcpy(np, omp, PAGEHDRSZ); /* Copy header of page */
+ omp = np;
+ }
+ node_set_ds(node, data->iov_len);
+ if (F_ISSET(flags, MDBX_RESERVE))
+ data->iov_base = page_data(omp);
+ else
+ memcpy(page_data(omp), data->iov_base, data->iov_len);
+
+ if (mdbx_audit_enabled()) {
+ int err = mdbx_cursor_check(mc, false);
+ if (unlikely(err != MDBX_SUCCESS))
+ return err;
+ }
+ return MDBX_SUCCESS;
+ }
+ }
+ if ((rc2 = mdbx_page_retire(mc, omp)) != MDBX_SUCCESS)
+ return rc2;
+ } else {
+ olddata.iov_len = node_ds(node);
+ olddata.iov_base = node_data(node);
+ mdbx_cassert(mc, (char *)olddata.iov_base + olddata.iov_len <=
+ (char *)(mc->mc_pg[mc->mc_top]) + env->me_psize);
+
+ /* DB has dups? */
+ if (F_ISSET(mc->mc_db->md_flags, MDBX_DUPSORT)) {
+ /* Prepare (sub-)page/sub-DB to accept the new item, if needed.
+ * fp: old sub-page or a header faking it.
+ * mp: new (sub-)page. offset: growth in page size.
+ * xdata: node data with new page or DB. */
+ unsigned i;
+ size_t offset = 0;
+ MDBX_page *mp = fp = xdata.iov_base = env->me_pbuf;
+ mp->mp_pgno = mc->mc_pg[mc->mc_top]->mp_pgno;
+
+ /* Was a single item before, must convert now */
+ if (!F_ISSET(node_flags(node), F_DUPDATA)) {
+
+ /* Just overwrite the current item */
+ if (flags & MDBX_CURRENT) {
+ mdbx_cassert(mc, node_size(key, data) <= env->me_nodemax);
+ goto current;
+ }
+
+ /* does data match? */
+ if (!mc->mc_dbx->md_dcmp(data, &olddata)) {
+ if (unlikely(flags & (MDBX_NODUPDATA | MDBX_APPENDDUP)))
+ return MDBX_KEYEXIST;
+ /* overwrite it */
+ mdbx_cassert(mc, node_size(key, data) <= env->me_nodemax);
+ goto current;
+ }
+
+ /* Back up original data item */
+ dupdata_flag = 1;
+ dkey.iov_len = olddata.iov_len;
+ dkey.iov_base = memcpy(fp + 1, olddata.iov_base, olddata.iov_len);
+
+ /* Make sub-page header for the dup items, with dummy body */
+ fp->mp_flags = P_LEAF | P_DIRTY | P_SUBP;
+ fp->mp_lower = 0;
+ xdata.iov_len = PAGEHDRSZ + dkey.iov_len + data->iov_len;
+ if (mc->mc_db->md_flags & MDBX_DUPFIXED) {
+ fp->mp_flags |= P_LEAF2;
+ fp->mp_leaf2_ksize = (uint16_t)data->iov_len;
+ xdata.iov_len += 2 * data->iov_len; /* leave space for 2 more */
+ mdbx_cassert(mc, xdata.iov_len <= env->me_psize);
+ } else {
+ xdata.iov_len += 2 * (sizeof(indx_t) + NODESIZE) +
+ (dkey.iov_len & 1) + (data->iov_len & 1);
+ mdbx_cassert(mc, xdata.iov_len <= env->me_psize);
+ }
+ fp->mp_upper = (uint16_t)(xdata.iov_len - PAGEHDRSZ);
+ olddata.iov_len = xdata.iov_len; /* pretend olddata is fp */
+ } else if (node_flags(node) & F_SUBDATA) {
+ /* Data is on sub-DB, just store it */
+ flags |= F_DUPDATA | F_SUBDATA;
+ goto put_sub;
+ } else {
+ /* Data is on sub-page */
+ fp = olddata.iov_base;
+ switch (flags) {
+ default:
+ if (!(mc->mc_db->md_flags & MDBX_DUPFIXED)) {
+ offset = node_size(data, nullptr) + sizeof(indx_t);
+ break;
+ }
+ offset = fp->mp_leaf2_ksize;
+ if (page_room(fp) < offset) {
+ offset *= 4; /* space for 4 more */
+ break;
+ }
+ /* FALLTHRU: Big enough MDBX_DUPFIXED sub-page */
+ __fallthrough;
+ case MDBX_CURRENT | MDBX_NODUPDATA:
+ case MDBX_CURRENT:
+ fp->mp_flags |= P_DIRTY;
+ fp->mp_pgno = mp->mp_pgno;
+ mc->mc_xcursor->mx_cursor.mc_pg[0] = fp;
+ flags |= F_DUPDATA;
+ goto put_sub;
+ }
+ xdata.iov_len = olddata.iov_len + offset;
+ }
+
+ fp_flags = fp->mp_flags;
+ if (NODESIZE + node_ks(node) + xdata.iov_len > env->me_nodemax) {
+ /* Too big for a sub-page, convert to sub-DB */
+ fp_flags &= ~P_SUBP;
+ prep_subDB:
+ nested_dupdb.md_xsize = 0;
+ nested_dupdb.md_flags = 0;
+ if (mc->mc_db->md_flags & MDBX_DUPFIXED) {
+ fp_flags |= P_LEAF2;
+ nested_dupdb.md_xsize = fp->mp_leaf2_ksize;
+ nested_dupdb.md_flags = MDBX_DUPFIXED;
+ if (mc->mc_db->md_flags & MDBX_INTEGERDUP)
+ nested_dupdb.md_flags |= MDBX_INTEGERKEY;
+ }
+ nested_dupdb.md_depth = 1;
+ nested_dupdb.md_branch_pages = 0;
+ nested_dupdb.md_leaf_pages = 1;
+ nested_dupdb.md_overflow_pages = 0;
+ nested_dupdb.md_entries = page_numkeys(fp);
+ xdata.iov_len = sizeof(nested_dupdb);
+ xdata.iov_base = &nested_dupdb;
+ if ((rc = mdbx_page_alloc(mc, 1, &mp, MDBX_ALLOC_ALL)))
+ return rc;
+ mc->mc_db->md_leaf_pages += 1;
+ mdbx_cassert(mc, env->me_psize > olddata.iov_len);
+ offset = env->me_psize - (unsigned)olddata.iov_len;
+ flags |= F_DUPDATA | F_SUBDATA;
+ nested_dupdb.md_root = mp->mp_pgno;
+ nested_dupdb.md_seq = nested_dupdb.md_mod_txnid = 0;
+ sub_root = mp;
+ }
+ if (mp != fp) {
+ mp->mp_flags = fp_flags | P_DIRTY;
+ mp->mp_leaf2_ksize = fp->mp_leaf2_ksize;
+ mp->mp_lower = fp->mp_lower;
+ mdbx_cassert(mc, fp->mp_upper + offset <= UINT16_MAX);
+ mp->mp_upper = (indx_t)(fp->mp_upper + offset);
+ if (unlikely(fp_flags & P_LEAF2)) {
+ memcpy(page_data(mp), page_data(fp),
+ page_numkeys(fp) * fp->mp_leaf2_ksize);
+ } else {
+ memcpy((char *)mp + mp->mp_upper + PAGEHDRSZ,
+ (char *)fp + fp->mp_upper + PAGEHDRSZ,
+ olddata.iov_len - fp->mp_upper - PAGEHDRSZ);
+ memcpy((char *)(&mp->mp_ptrs), (char *)(&fp->mp_ptrs),
+ page_numkeys(fp) * sizeof(mp->mp_ptrs[0]));
+ for (i = 0; i < page_numkeys(fp); i++) {
+ mdbx_cassert(mc, mp->mp_ptrs[i] + offset <= UINT16_MAX);
+ mp->mp_ptrs[i] += (indx_t)offset;
+ }
+ }
+ }
+
+ rdata = &xdata;
+ flags |= F_DUPDATA;
+ do_sub = true;
+ if (!insert_key)
+ mdbx_node_del(mc, 0);
+ goto new_sub;
+ }
+
+ /* MDBX passes F_SUBDATA in 'flags' to write a DB record */
+ if (unlikely((node_flags(node) ^ flags) & F_SUBDATA))
+ return MDBX_INCOMPATIBLE;
+
+ current:
+ if (data->iov_len == olddata.iov_len) {
+ mdbx_cassert(mc, EVEN(key->iov_len) == EVEN(node_ks(node)));
+ /* same size, just replace it. Note that we could
+ * also reuse this node if the new data is smaller,
+ * but instead we opt to shrink the node in that case. */
+ if (F_ISSET(flags, MDBX_RESERVE))
+ data->iov_base = olddata.iov_base;
+ else if (!(mc->mc_flags & C_SUB))
+ memcpy(olddata.iov_base, data->iov_base, data->iov_len);
+ else {
+ mdbx_cassert(mc, page_numkeys(mc->mc_pg[mc->mc_top]) == 1);
+ mdbx_cassert(mc, PAGETYPE(mc->mc_pg[mc->mc_top]) == P_LEAF);
+ mdbx_cassert(mc, node_ds(node) == 0);
+ mdbx_cassert(mc, node_flags(node) == 0);
+ mdbx_cassert(mc, key->iov_len < UINT16_MAX);
+ node_set_ks(node, key->iov_len);
+ memcpy(node_key(node), key->iov_base, key->iov_len);
+ mdbx_cassert(mc, (char *)node_key(node) + node_ds(node) <
+ (char *)(mc->mc_pg[mc->mc_top]) + env->me_psize);
+ goto fix_parent;
+ }
+
+ if (mdbx_audit_enabled()) {
+ int err = mdbx_cursor_check(mc, false);
+ if (unlikely(err != MDBX_SUCCESS))
+ return err;
+ }
+ return MDBX_SUCCESS;
+ }
+ }
+ mdbx_node_del(mc, 0);
+ }
+
+ rdata = data;
+
+new_sub:
+ nflags = flags & NODE_ADD_FLAGS;
+ nsize = IS_LEAF2(mc->mc_pg[mc->mc_top]) ? key->iov_len
+ : leaf_size(env, key, rdata);
+ if (page_room(mc->mc_pg[mc->mc_top]) < nsize) {
+ if ((flags & (F_DUPDATA | F_SUBDATA)) == F_DUPDATA)
+ nflags &= ~MDBX_APPEND; /* sub-page may need room to grow */
+ if (!insert_key)
+ nflags |= MDBX_SPLIT_REPLACE;
+ rc = mdbx_page_split(mc, key, rdata, P_INVALID, nflags);
+ if (rc == MDBX_SUCCESS && mdbx_audit_enabled())
+ rc = mdbx_cursor_check(mc, false);
+ } else {
+ /* There is room already in this leaf page. */
+ if (IS_LEAF2(mc->mc_pg[mc->mc_top])) {
+ mdbx_cassert(mc, (nflags & (F_BIGDATA | F_SUBDATA | F_DUPDATA)) == 0 &&
+ rdata->iov_len == 0);
+ rc = mdbx_node_add_leaf2(mc, mc->mc_ki[mc->mc_top], key);
+ } else
+ rc = mdbx_node_add_leaf(mc, mc->mc_ki[mc->mc_top], key, rdata, nflags);
+ if (likely(rc == 0)) {
+ /* Adjust other cursors pointing to mp */
+ MDBX_cursor *m2, *m3;
+ MDBX_dbi dbi = mc->mc_dbi;
+ unsigned i = mc->mc_top;
+ MDBX_page *mp = mc->mc_pg[i];
+
+ for (m2 = mc->mc_txn->mt_cursors[dbi]; m2; m2 = m2->mc_next) {
+ m3 = (mc->mc_flags & C_SUB) ? &m2->mc_xcursor->mx_cursor : m2;
+ if (m3 == mc || m3->mc_snum < mc->mc_snum || m3->mc_pg[i] != mp)
+ continue;
+ if (m3->mc_ki[i] >= mc->mc_ki[i] && insert_key) {
+ m3->mc_ki[i]++;
+ }
+ if (XCURSOR_INITED(m3))
+ XCURSOR_REFRESH(m3, mp, m3->mc_ki[i]);
+ }
+ }
+ }
+
+ if (likely(rc == MDBX_SUCCESS)) {
+ /* Now store the actual data in the child DB. Note that we're
+ * storing the user data in the keys field, so there are strict
+ * size limits on dupdata. The actual data fields of the child
+ * DB are all zero size. */
+ if (do_sub) {
+ int xflags;
+ size_t ecount;
+ put_sub:
+ xdata.iov_len = 0;
+ xdata.iov_base = nullptr;
+ MDBX_node *node = page_node(mc->mc_pg[mc->mc_top], mc->mc_ki[mc->mc_top]);
+ if (flags & MDBX_CURRENT) {
+ xflags = (flags & MDBX_NODUPDATA)
+ ? MDBX_CURRENT | MDBX_NOOVERWRITE | MDBX_NOSPILL
+ : MDBX_CURRENT | MDBX_NOSPILL;
+ } else {
+ rc2 = mdbx_xcursor_init1(mc, node);
+ if (unlikely(rc2 != MDBX_SUCCESS))
+ return rc2;
+ xflags = (flags & MDBX_NODUPDATA) ? MDBX_NOOVERWRITE | MDBX_NOSPILL
+ : MDBX_NOSPILL;
+ }
+ if (sub_root)
+ mc->mc_xcursor->mx_cursor.mc_pg[0] = sub_root;
+ /* converted, write the original data first */
+ if (dupdata_flag) {
+ rc = mdbx_cursor_put(&mc->mc_xcursor->mx_cursor, &dkey, &xdata, xflags);
+ if (unlikely(rc))
+ goto bad_sub;
+ /* we've done our job */
+ dkey.iov_len = 0;
+ }
+ if (!(node_flags(node) & F_SUBDATA) || sub_root) {
+ /* Adjust other cursors pointing to mp */
+ MDBX_cursor *m2;
+ MDBX_xcursor *mx = mc->mc_xcursor;
+ unsigned i = mc->mc_top;
+ MDBX_page *mp = mc->mc_pg[i];
+ const int nkeys = page_numkeys(mp);
+
+ for (m2 = mc->mc_txn->mt_cursors[mc->mc_dbi]; m2; m2 = m2->mc_next) {
+ if (m2 == mc || m2->mc_snum < mc->mc_snum)
+ continue;
+ if (!(m2->mc_flags & C_INITIALIZED))
+ continue;
+ if (m2->mc_pg[i] == mp) {
+ if (m2->mc_ki[i] == mc->mc_ki[i]) {
+ rc2 = mdbx_xcursor_init2(m2, mx, dupdata_flag);
+ if (unlikely(rc2 != MDBX_SUCCESS))
+ return rc2;
+ } else if (!insert_key && m2->mc_ki[i] < nkeys) {
+ XCURSOR_REFRESH(m2, mp, m2->mc_ki[i]);
+ }
+ }
+ }
+ }
+ mdbx_cassert(mc, mc->mc_xcursor->mx_db.md_entries < PTRDIFF_MAX);
+ ecount = (size_t)mc->mc_xcursor->mx_db.md_entries;
+ if (flags & MDBX_APPENDDUP)
+ xflags |= MDBX_APPEND;
+ rc = mdbx_cursor_put(&mc->mc_xcursor->mx_cursor, data, &xdata, xflags);
+ if (flags & F_SUBDATA) {
+ void *db = node_data(node);
+ memcpy(db, &mc->mc_xcursor->mx_db, sizeof(MDBX_db));
+ }
+ insert_data = (ecount != (size_t)mc->mc_xcursor->mx_db.md_entries);
+ }
+ /* Increment count unless we just replaced an existing item. */
+ if (insert_data)
+ mc->mc_db->md_entries++;
+ if (insert_key) {
+ /* Invalidate txn if we created an empty sub-DB */
+ if (unlikely(rc))
+ goto bad_sub;
+ /* If we succeeded and the key didn't exist before,
+ * make sure the cursor is marked valid. */
+ mc->mc_flags |= C_INITIALIZED;
+ }
+ if (flags & MDBX_MULTIPLE) {
+ if (!rc) {
+ mcount++;
+ /* let caller know how many succeeded, if any */
+ data[1].iov_len = mcount;
+ if (mcount < dcount) {
+ data[0].iov_base = (char *)data[0].iov_base + data[0].iov_len;
+ insert_key = insert_data = false;
+ goto more;
+ }
+ }
+ }
+ if (rc == MDBX_SUCCESS && mdbx_audit_enabled())
+ rc = mdbx_cursor_check(mc, false);
+ return rc;
+ bad_sub:
+ if (unlikely(rc == MDBX_KEYEXIST))
+ mdbx_error("unexpected %s", "MDBX_KEYEXIST");
+ /* should not happen, we deleted that item */
+ rc = MDBX_PROBLEM;
+ }
+fail:
+ mc->mc_txn->mt_flags |= MDBX_TXN_ERROR;
+ return rc;
+}
+
+int mdbx_cursor_del(MDBX_cursor *mc, unsigned flags) {
+ if (unlikely(!mc))
+ return MDBX_EINVAL;
+
+ if (unlikely(mc->mc_signature != MDBX_MC_SIGNATURE))
+ return MDBX_EBADSIGN;
+
+ int rc = check_txn_rw(mc->mc_txn, MDBX_TXN_BLOCKED);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ if (unlikely(!(mc->mc_flags & C_INITIALIZED)))
+ return MDBX_EINVAL;
+
+ if (unlikely(mc->mc_ki[mc->mc_top] >= page_numkeys(mc->mc_pg[mc->mc_top])))
+ return MDBX_NOTFOUND;
+
+ if (unlikely(!(flags & MDBX_NOSPILL) &&
+ (rc = mdbx_page_spill(mc, NULL, NULL))))
+ return rc;
+
+ rc = mdbx_cursor_touch(mc);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ MDBX_page *mp = mc->mc_pg[mc->mc_top];
+ if (IS_LEAF2(mp))
+ goto del_key;
+
+ MDBX_node *node = page_node(mp, mc->mc_ki[mc->mc_top]);
+ if (F_ISSET(node_flags(node), F_DUPDATA)) {
+ if (flags & MDBX_NODUPDATA) {
+ /* mdbx_cursor_del0() will subtract the final entry */
+ mc->mc_db->md_entries -= mc->mc_xcursor->mx_db.md_entries - 1;
+ mc->mc_xcursor->mx_cursor.mc_flags &= ~C_INITIALIZED;
+ } else {
+ if (!F_ISSET(node_flags(node), F_SUBDATA)) {
+ mc->mc_xcursor->mx_cursor.mc_pg[0] = node_data(node);
+ }
+ rc = mdbx_cursor_del(&mc->mc_xcursor->mx_cursor, MDBX_NOSPILL);
+ if (unlikely(rc))
+ return rc;
+ /* If sub-DB still has entries, we're done */
+ if (mc->mc_xcursor->mx_db.md_entries) {
+ if (node_flags(node) & F_SUBDATA) {
+ /* update subDB info */
+ void *db = node_data(node);
+ memcpy(db, &mc->mc_xcursor->mx_db, sizeof(MDBX_db));
+ } else {
+ MDBX_cursor *m2;
+ /* shrink fake page */
+ mdbx_node_shrink(mp, mc->mc_ki[mc->mc_top]);
+ node = page_node(mp, mc->mc_ki[mc->mc_top]);
+ mc->mc_xcursor->mx_cursor.mc_pg[0] = node_data(node);
+ /* fix other sub-DB cursors pointed at fake pages on this page */
+ for (m2 = mc->mc_txn->mt_cursors[mc->mc_dbi]; m2; m2 = m2->mc_next) {
+ if (m2 == mc || m2->mc_snum < mc->mc_snum)
+ continue;
+ if (!(m2->mc_flags & C_INITIALIZED))
+ continue;
+ if (m2->mc_pg[mc->mc_top] == mp) {
+ MDBX_node *inner = node;
+ if (m2->mc_ki[mc->mc_top] >= page_numkeys(mp))
+ continue;
+ if (m2->mc_ki[mc->mc_top] != mc->mc_ki[mc->mc_top]) {
+ inner = page_node(mp, m2->mc_ki[mc->mc_top]);
+ if (node_flags(inner) & F_SUBDATA)
+ continue;
+ }
+ m2->mc_xcursor->mx_cursor.mc_pg[0] = node_data(inner);
+ }
+ }
+ }
+ mc->mc_db->md_entries--;
+ mdbx_cassert(mc, mc->mc_db->md_entries > 0 && mc->mc_db->md_depth > 0 &&
+ mc->mc_db->md_root != P_INVALID);
+ return rc;
+ } else {
+ mc->mc_xcursor->mx_cursor.mc_flags &= ~C_INITIALIZED;
+ }
+ /* otherwise fall thru and delete the sub-DB */
+ }
+
+ if (node_flags(node) & F_SUBDATA) {
+ /* add all the child DB's pages to the free list */
+ rc = mdbx_drop0(&mc->mc_xcursor->mx_cursor, 0);
+ if (unlikely(rc))
+ goto fail;
+ }
+ }
+ /* MDBX passes F_SUBDATA in 'flags' to delete a DB record */
+ else if (unlikely((node_flags(node) ^ flags) & F_SUBDATA)) {
+ rc = MDBX_INCOMPATIBLE;
+ goto fail;
+ }
+
+ /* add overflow pages to free list */
+ if (F_ISSET(node_flags(node), F_BIGDATA)) {
+ MDBX_page *omp;
+ if (unlikely(
+ (rc = mdbx_page_get(mc, node_largedata_pgno(node), &omp, NULL)) ||
+ (rc = mdbx_page_retire(mc, omp))))
+ goto fail;
+ }
+
+del_key:
+ return mdbx_cursor_del0(mc);
+
+fail:
+ mc->mc_txn->mt_flags |= MDBX_TXN_ERROR;
+ return rc;
+}
+
+/* Allocate and initialize new pages for a database.
+ * Set MDBX_TXN_ERROR on failure.
+ *
+ * [in] mc a cursor on the database being added to.
+ * [in] flags flags defining what type of page is being allocated.
+ * [in] num the number of pages to allocate. This is usually 1,
+ * unless allocating overflow pages for a large record.
+ * [out] mp Address of a page, or NULL on failure.
+ *
+ * Returns 0 on success, non-zero on failure. */
+static int mdbx_page_new(MDBX_cursor *mc, unsigned flags, unsigned num,
+ MDBX_page **mp) {
+ MDBX_page *np;
+ int rc;
+
+ if (unlikely((rc = mdbx_page_alloc(mc, num, &np, MDBX_ALLOC_ALL))))
+ return rc;
+ *mp = np;
+ mdbx_debug("allocated new page #%" PRIaPGNO ", size %u", np->mp_pgno,
+ mc->mc_txn->mt_env->me_psize);
+ np->mp_flags = (uint16_t)(flags | P_DIRTY);
+ np->mp_lower = 0;
+ np->mp_upper = (indx_t)(mc->mc_txn->mt_env->me_psize - PAGEHDRSZ);
+
+ mc->mc_db->md_branch_pages += IS_BRANCH(np);
+ mc->mc_db->md_leaf_pages += IS_LEAF(np);
+ if (unlikely(IS_OVERFLOW(np))) {
+ mc->mc_db->md_overflow_pages += num;
+ np->mp_pages = num;
+ mdbx_cassert(mc, !(mc->mc_flags & C_SUB));
+ } else if (unlikely(mc->mc_flags & C_SUB)) {
+ MDBX_db *outer = mdbx_outer_db(mc);
+ outer->md_branch_pages += IS_BRANCH(np);
+ outer->md_leaf_pages += IS_LEAF(np);
+ }
+
+ return MDBX_SUCCESS;
+}
+
+static int __must_check_result mdbx_node_add_leaf2(MDBX_cursor *mc,
+ unsigned indx,
+ const MDBX_val *key) {
+ MDBX_page *mp = mc->mc_pg[mc->mc_top];
+ DKBUF;
+ mdbx_debug("add to leaf2-%spage %" PRIaPGNO " index %i, "
+ " key size %" PRIuPTR " [%s]",
+ IS_SUBP(mp) ? "sub-" : "", mp->mp_pgno, indx,
+ key ? key->iov_len : 0, DKEY(key));
+
+ mdbx_cassert(mc, key);
+ mdbx_cassert(mc, PAGETYPE(mp) == (P_LEAF | P_LEAF2));
+ const unsigned ksize = mc->mc_db->md_xsize;
+ mdbx_cassert(mc, ksize == key->iov_len);
+ const unsigned nkeys = page_numkeys(mp);
+
+ /* Just using these for counting */
+ const intptr_t lower = mp->mp_lower + sizeof(indx_t);
+ const intptr_t upper = mp->mp_upper - (ksize - sizeof(indx_t));
+ if (unlikely(lower > upper)) {
+ mc->mc_txn->mt_flags |= MDBX_TXN_ERROR;
+ return MDBX_PAGE_FULL;
+ }
+ mp->mp_lower = (indx_t)lower;
+ mp->mp_upper = (indx_t)upper;
+
+ char *const ptr = page_leaf2key(mp, indx, ksize);
+ mdbx_cassert(mc, nkeys >= indx);
+ const unsigned diff = nkeys - indx;
+ if (likely(diff > 0))
+ /* Move higher keys up one slot. */
+ memmove(ptr + ksize, ptr, diff * ksize);
+ /* insert new key */
+ memcpy(ptr, key->iov_base, ksize);
+ return MDBX_SUCCESS;
+}
+
+static int __must_check_result mdbx_node_add_branch(MDBX_cursor *mc,
+ unsigned indx,
+ const MDBX_val *key,
+ pgno_t pgno) {
+ MDBX_page *mp = mc->mc_pg[mc->mc_top];
+ DKBUF;
+ mdbx_debug("add to branch-%spage %" PRIaPGNO " index %i, node-pgno %" PRIaPGNO
+ " key size %" PRIuPTR " [%s]",
+ IS_SUBP(mp) ? "sub-" : "", mp->mp_pgno, indx, pgno,
+ key ? key->iov_len : 0, DKEY(key));
+
+ mdbx_cassert(mc, PAGETYPE(mp) == P_BRANCH);
+ STATIC_ASSERT(NODESIZE % 2 == 0);
+
+ /* Move higher pointers up one slot. */
+ const unsigned nkeys = page_numkeys(mp);
+ mdbx_cassert(mc, nkeys >= indx);
+ for (unsigned i = nkeys; i > indx; --i)
+ mp->mp_ptrs[i] = mp->mp_ptrs[i - 1];
+
+ /* Adjust free space offsets. */
+ const size_t branch_bytes = branch_size(mc->mc_txn->mt_env, key);
+ const intptr_t lower = mp->mp_lower + sizeof(indx_t);
+ const intptr_t upper = mp->mp_upper - (branch_bytes - sizeof(indx_t));
+ if (unlikely(lower > upper)) {
+ mc->mc_txn->mt_flags |= MDBX_TXN_ERROR;
+ return MDBX_PAGE_FULL;
+ }
+ mp->mp_lower = (indx_t)lower;
+ mp->mp_ptrs[indx] = mp->mp_upper = (indx_t)upper;
+
+ /* Write the node data. */
+ MDBX_node *node = page_node(mp, indx);
+ node_set_pgno(node, pgno);
+ node_set_flags(node, 0);
+ UNALIGNED_POKE_8(node, MDBX_node, mn_extra, 0);
+ node_set_ks(node, 0);
+ if (likely(key != NULL)) {
+ node_set_ks(node, key->iov_len);
+ memcpy(node_key(node), key->iov_base, key->iov_len);
+ }
+ return MDBX_SUCCESS;
+}
+
+static int __must_check_result mdbx_node_add_leaf(MDBX_cursor *mc,
+ unsigned indx,
+ const MDBX_val *key,
+ MDBX_val *data,
+ unsigned flags) {
+ MDBX_page *mp = mc->mc_pg[mc->mc_top];
+ DKBUF;
+ mdbx_debug("add to leaf-%spage %" PRIaPGNO " index %i, data size %" PRIuPTR
+ " key size %" PRIuPTR " [%s]",
+ IS_SUBP(mp) ? "sub-" : "", mp->mp_pgno, indx,
+ data ? data->iov_len : 0, key ? key->iov_len : 0, DKEY(key));
+ mdbx_cassert(mc, key != NULL && data != NULL);
+ mdbx_cassert(mc, PAGETYPE(mp) == P_LEAF);
+ MDBX_page *largepage = NULL;
+
+ size_t leaf_bytes = 0;
+ if (unlikely(flags & F_BIGDATA)) {
+ /* Data already on overflow page. */
+ STATIC_ASSERT(sizeof(pgno_t) % 2 == 0);
+ leaf_bytes = node_size(key, nullptr) + sizeof(pgno_t) + sizeof(indx_t);
+ } else if (unlikely(node_size(key, data) > mc->mc_txn->mt_env->me_nodemax)) {
+ /* Put data on overflow page. */
+ mdbx_cassert(mc, !F_ISSET(mc->mc_db->md_flags, MDBX_DUPSORT));
+ const pgno_t ovpages = number_of_ovpages(mc->mc_txn->mt_env, data->iov_len);
+ int rc = mdbx_page_new(mc, P_OVERFLOW, ovpages, &largepage);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+ mdbx_debug("allocated %u overflow page(s) %" PRIaPGNO "for %" PRIuPTR
+ " data bytes",
+ largepage->mp_pages, largepage->mp_pgno, data->iov_len);
+ flags |= F_BIGDATA;
+ leaf_bytes = node_size(key, nullptr) + sizeof(pgno_t) + sizeof(indx_t);
+ } else {
+ leaf_bytes = node_size(key, data) + sizeof(indx_t);
+ }
+ mdbx_cassert(mc, leaf_bytes == leaf_size(mc->mc_txn->mt_env, key, data));
+
+ /* Move higher pointers up one slot. */
+ const unsigned nkeys = page_numkeys(mp);
+ mdbx_cassert(mc, nkeys >= indx);
+ for (unsigned i = nkeys; i > indx; --i)
+ mp->mp_ptrs[i] = mp->mp_ptrs[i - 1];
+
+ /* Adjust free space offsets. */
+ const intptr_t lower = mp->mp_lower + sizeof(indx_t);
+ const intptr_t upper = mp->mp_upper - (leaf_bytes - sizeof(indx_t));
+ if (unlikely(lower > upper)) {
+ mc->mc_txn->mt_flags |= MDBX_TXN_ERROR;
+ return MDBX_PAGE_FULL;
+ }
+ mp->mp_lower = (indx_t)lower;
+ mp->mp_ptrs[indx] = mp->mp_upper = (indx_t)upper;
+
+ /* Write the node data. */
+ MDBX_node *node = page_node(mp, indx);
+ node_set_ks(node, key->iov_len);
+ node_set_flags(node, (uint8_t)flags);
+ UNALIGNED_POKE_8(node, MDBX_node, mn_extra, 0);
+ node_set_ds(node, data->iov_len);
+ memcpy(node_key(node), key->iov_base, key->iov_len);
+
+ void *nodedata = node_data(node);
+ if (likely(largepage == NULL)) {
+ if (unlikely(flags & F_BIGDATA))
+ memcpy(nodedata, data->iov_base, sizeof(pgno_t));
+ else if (unlikely(flags & MDBX_RESERVE))
+ data->iov_base = nodedata;
+ else if (likely(nodedata != data->iov_base))
+ memcpy(nodedata, data->iov_base, data->iov_len);
+ } else {
+ poke_pgno(nodedata, largepage->mp_pgno);
+ nodedata = page_data(largepage);
+ if (unlikely(flags & MDBX_RESERVE))
+ data->iov_base = nodedata;
+ else if (likely(nodedata != data->iov_base))
+ memcpy(nodedata, data->iov_base, data->iov_len);
+ }
+ return MDBX_SUCCESS;
+}
+
+/* Delete the specified node from a page.
+ * [in] mc Cursor pointing to the node to delete.
+ * [in] ksize The size of a node. Only used if the page is
+ * part of a MDBX_DUPFIXED database. */
+static void mdbx_node_del(MDBX_cursor *mc, size_t ksize) {
+ MDBX_page *mp = mc->mc_pg[mc->mc_top];
+ int indx = mc->mc_ki[mc->mc_top];
+ int i, j, nkeys, ptr;
+ MDBX_node *node;
+ char *base;
+
+ mdbx_debug("delete node %u on %s page %" PRIaPGNO, indx,
+ IS_LEAF(mp) ? "leaf" : "branch", mp->mp_pgno);
+ nkeys = page_numkeys(mp);
+ mdbx_cassert(mc, indx < nkeys);
+
+ if (IS_LEAF2(mp)) {
+ mdbx_cassert(mc, ksize >= sizeof(indx_t));
+ unsigned diff = nkeys - 1 - indx;
+ base = page_leaf2key(mp, indx, ksize);
+ if (diff)
+ memmove(base, base + ksize, diff * ksize);
+ mdbx_cassert(mc, mp->mp_lower >= sizeof(indx_t));
+ mp->mp_lower -= sizeof(indx_t);
+ mdbx_cassert(mc,
+ (size_t)UINT16_MAX - mp->mp_upper >= ksize - sizeof(indx_t));
+ mp->mp_upper += (indx_t)(ksize - sizeof(indx_t));
+ return;
+ }
+
+ node = page_node(mp, indx);
+ size_t sz = NODESIZE + node_ks(node);
+ if (IS_LEAF(mp)) {
+ if (F_ISSET(node_flags(node), F_BIGDATA))
+ sz += sizeof(pgno_t);
+ else
+ sz += node_ds(node);
+ }
+ sz = EVEN(sz);
+
+ ptr = mp->mp_ptrs[indx];
+ for (i = j = 0; i < nkeys; i++) {
+ if (i != indx) {
+ mp->mp_ptrs[j] = mp->mp_ptrs[i];
+ if (mp->mp_ptrs[i] < ptr) {
+ mdbx_cassert(mc, (size_t)UINT16_MAX - mp->mp_ptrs[j] >= sz);
+ mp->mp_ptrs[j] += (indx_t)sz;
+ }
+ j++;
+ }
+ }
+
+ base = (char *)mp + mp->mp_upper + PAGEHDRSZ;
+ memmove(base + sz, base, ptr - mp->mp_upper);
+
+ mdbx_cassert(mc, mp->mp_lower >= sizeof(indx_t));
+ mp->mp_lower -= sizeof(indx_t);
+ mdbx_cassert(mc, (size_t)UINT16_MAX - mp->mp_upper >= sz);
+ mp->mp_upper += (indx_t)sz;
+}
+
+/* Compact the main page after deleting a node on a subpage.
+ * [in] mp The main page to operate on.
+ * [in] indx The index of the subpage on the main page. */
+static void mdbx_node_shrink(MDBX_page *mp, unsigned indx) {
+ MDBX_node *node;
+ MDBX_page *sp, *xp;
+ char *base;
+ size_t nsize, delta, len, ptr;
+ int i;
+
+ node = page_node(mp, indx);
+ sp = (MDBX_page *)node_data(node);
+ delta = page_room(sp);
+ assert(delta > 0);
+
+ /* Prepare to shift upward, set len = length(subpage part to shift) */
+ if (IS_LEAF2(sp)) {
+ delta &= /* do not make the node uneven-sized */ ~1u;
+ if (unlikely(delta) == 0)
+ return;
+ nsize = node_ds(node) - delta;
+ assert(nsize % 1 == 0);
+ len = nsize;
+ } else {
+ xp = (MDBX_page *)((char *)sp + delta); /* destination subpage */
+ for (i = page_numkeys(sp); --i >= 0;) {
+ assert(sp->mp_ptrs[i] >= delta);
+ xp->mp_ptrs[i] = (indx_t)(sp->mp_ptrs[i] - delta);
+ }
+ nsize = node_ds(node) - delta;
+ len = PAGEHDRSZ;
+ }
+ sp->mp_upper = sp->mp_lower;
+ sp->mp_pgno = mp->mp_pgno;
+ node_set_ds(node, nsize);
+
+ /* Shift upward */
+ base = (char *)mp + mp->mp_upper + PAGEHDRSZ;
+ memmove(base + delta, base, (char *)sp + len - base);
+
+ ptr = mp->mp_ptrs[indx];
+ for (i = page_numkeys(mp); --i >= 0;) {
+ if (mp->mp_ptrs[i] <= ptr) {
+ assert((size_t)UINT16_MAX - mp->mp_ptrs[i] >= delta);
+ mp->mp_ptrs[i] += (indx_t)delta;
+ }
+ }
+ assert((size_t)UINT16_MAX - mp->mp_upper >= delta);
+ mp->mp_upper += (indx_t)delta;
+}
+
+/* Initial setup of a sorted-dups cursor.
+ *
+ * Sorted duplicates are implemented as a sub-database for the given key.
+ * The duplicate data items are actually keys of the sub-database.
+ * Operations on the duplicate data items are performed using a sub-cursor
+ * initialized when the sub-database is first accessed. This function does
+ * the preliminary setup of the sub-cursor, filling in the fields that
+ * depend only on the parent DB.
+ *
+ * [in] mc The main cursor whose sorted-dups cursor is to be initialized. */
+static int mdbx_xcursor_init0(MDBX_cursor *mc) {
+ MDBX_xcursor *mx = mc->mc_xcursor;
+ if (unlikely(mx == nullptr))
+ return MDBX_CORRUPTED;
+
+ mx->mx_cursor.mc_xcursor = NULL;
+ mx->mx_cursor.mc_txn = mc->mc_txn;
+ mx->mx_cursor.mc_db = &mx->mx_db;
+ mx->mx_cursor.mc_dbx = &mx->mx_dbx;
+ mx->mx_cursor.mc_dbi = mc->mc_dbi;
+ mx->mx_cursor.mc_dbflag = &mx->mx_dbflag;
+ mx->mx_cursor.mc_snum = 0;
+ mx->mx_cursor.mc_top = 0;
+ mx->mx_cursor.mc_flags = C_SUB;
+ mx->mx_dbx.md_name.iov_len = 0;
+ mx->mx_dbx.md_name.iov_base = NULL;
+ mx->mx_dbx.md_cmp = mc->mc_dbx->md_dcmp;
+ mx->mx_dbx.md_dcmp = NULL;
+ return MDBX_SUCCESS;
+}
+
+/* Final setup of a sorted-dups cursor.
+ * Sets up the fields that depend on the data from the main cursor.
+ * [in] mc The main cursor whose sorted-dups cursor is to be initialized.
+ * [in] node The data containing the MDBX_db record for the sorted-dup database.
+ */
+static int mdbx_xcursor_init1(MDBX_cursor *mc, MDBX_node *node) {
+ MDBX_xcursor *mx = mc->mc_xcursor;
+ if (unlikely(mx == nullptr))
+ return MDBX_CORRUPTED;
+
+ if (node_flags(node) & F_SUBDATA) {
+ if (unlikely(node_ds(node) != sizeof(MDBX_db)))
+ return MDBX_CORRUPTED;
+ memcpy(&mx->mx_db, node_data(node), sizeof(MDBX_db));
+ mx->mx_cursor.mc_pg[0] = 0;
+ mx->mx_cursor.mc_snum = 0;
+ mx->mx_cursor.mc_top = 0;
+ mx->mx_cursor.mc_flags = C_SUB;
+ } else {
+ if (unlikely(node_ds(node) <= PAGEHDRSZ))
+ return MDBX_CORRUPTED;
+ MDBX_page *fp = node_data(node);
+ mx->mx_db.md_xsize = 0;
+ mx->mx_db.md_flags = 0;
+ mx->mx_db.md_depth = 1;
+ mx->mx_db.md_branch_pages = 0;
+ mx->mx_db.md_leaf_pages = 1;
+ mx->mx_db.md_overflow_pages = 0;
+ mx->mx_db.md_entries = page_numkeys(fp);
+ mx->mx_db.md_root = fp->mp_pgno;
+ mx->mx_cursor.mc_snum = 1;
+ mx->mx_cursor.mc_top = 0;
+ mx->mx_cursor.mc_flags = C_INITIALIZED | C_SUB;
+ mx->mx_cursor.mc_pg[0] = fp;
+ mx->mx_cursor.mc_ki[0] = 0;
+ if (mc->mc_db->md_flags & MDBX_DUPFIXED) {
+ mx->mx_db.md_flags = MDBX_DUPFIXED;
+ mx->mx_db.md_xsize = fp->mp_leaf2_ksize;
+ if (mc->mc_db->md_flags & MDBX_INTEGERDUP)
+ mx->mx_db.md_flags |= MDBX_INTEGERKEY;
+ }
+ }
+ mdbx_debug("Sub-db -%u root page %" PRIaPGNO, mx->mx_cursor.mc_dbi,
+ mx->mx_db.md_root);
+ mx->mx_dbflag = DB_VALID | DB_USRVALID | DB_DUPDATA;
+ return MDBX_SUCCESS;
+}
+
+/* Fixup a sorted-dups cursor due to underlying update.
+ * Sets up some fields that depend on the data from the main cursor.
+ * Almost the same as init1, but skips initialization steps if the
+ * xcursor had already been used.
+ * [in] mc The main cursor whose sorted-dups cursor is to be fixed up.
+ * [in] src_mx The xcursor of an up-to-date cursor.
+ * [in] new_dupdata True if converting from a non-F_DUPDATA item. */
+static int mdbx_xcursor_init2(MDBX_cursor *mc, MDBX_xcursor *src_mx,
+ int new_dupdata) {
+ MDBX_xcursor *mx = mc->mc_xcursor;
+ if (unlikely(mx == nullptr))
+ return MDBX_CORRUPTED;
+
+ if (new_dupdata) {
+ mx->mx_cursor.mc_snum = 1;
+ mx->mx_cursor.mc_top = 0;
+ mx->mx_cursor.mc_flags |= C_INITIALIZED;
+ mx->mx_cursor.mc_ki[0] = 0;
+ mx->mx_dbflag = DB_VALID | DB_USRVALID | DB_DUPDATA;
+ mx->mx_dbx.md_cmp = src_mx->mx_dbx.md_cmp;
+ } else if (!(mx->mx_cursor.mc_flags & C_INITIALIZED)) {
+ return MDBX_SUCCESS;
+ }
+ mx->mx_db = src_mx->mx_db;
+ mx->mx_cursor.mc_pg[0] = src_mx->mx_cursor.mc_pg[0];
+ mdbx_debug("Sub-db -%u root page %" PRIaPGNO, mx->mx_cursor.mc_dbi,
+ mx->mx_db.md_root);
+ return MDBX_SUCCESS;
+}
+
+/* Initialize a cursor for a given transaction and database. */
+static int mdbx_cursor_init(MDBX_cursor *mc, MDBX_txn *txn, MDBX_dbi dbi) {
+ mc->mc_signature = MDBX_MC_SIGNATURE;
+ mc->mc_next = NULL;
+ mc->mc_backup = NULL;
+ mc->mc_dbi = dbi;
+ mc->mc_txn = txn;
+ mc->mc_db = &txn->mt_dbs[dbi];
+ mc->mc_dbx = &txn->mt_dbxs[dbi];
+ mc->mc_dbflag = &txn->mt_dbflags[dbi];
+ mc->mc_snum = 0;
+ mc->mc_top = 0;
+ mc->mc_pg[0] = 0;
+ mc->mc_flags = 0;
+ mc->mc_ki[0] = 0;
+ mc->mc_xcursor = NULL;
+
+ if (txn->mt_dbs[dbi].md_flags & MDBX_DUPSORT) {
+ STATIC_ASSERT(offsetof(MDBX_cursor_couple, outer) == 0);
+ MDBX_xcursor *mx = &container_of(mc, MDBX_cursor_couple, outer)->inner;
+ mdbx_tassert(txn, mx != NULL);
+ mx->mx_cursor.mc_signature = MDBX_MC_SIGNATURE;
+ mc->mc_xcursor = mx;
+ int rc = mdbx_xcursor_init0(mc);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+ }
+
+ int rc = MDBX_SUCCESS;
+ if (unlikely(*mc->mc_dbflag & DB_STALE)) {
+ rc = mdbx_page_search(mc, NULL, MDBX_PS_ROOTONLY);
+ rc = (rc != MDBX_NOTFOUND) ? rc : MDBX_SUCCESS;
+ }
+ return rc;
+}
+
+int mdbx_cursor_open(MDBX_txn *txn, MDBX_dbi dbi, MDBX_cursor **ret) {
+ if (unlikely(!ret))
+ return MDBX_EINVAL;
+ *ret = NULL;
+
+ int rc = check_txn(txn, MDBX_TXN_BLOCKED);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ if (unlikely(!TXN_DBI_EXIST(txn, dbi, DB_VALID)))
+ return MDBX_EINVAL;
+
+ if (unlikely(dbi == FREE_DBI && !F_ISSET(txn->mt_flags, MDBX_RDONLY)))
+ return MDBX_EACCESS;
+
+ const size_t size = (txn->mt_dbs[dbi].md_flags & MDBX_DUPSORT)
+ ? sizeof(MDBX_cursor_couple)
+ : sizeof(MDBX_cursor);
+
+ MDBX_cursor *mc;
+ if (likely((mc = mdbx_malloc(size)) != NULL)) {
+ rc = mdbx_cursor_init(mc, txn, dbi);
+ if (unlikely(rc != MDBX_SUCCESS)) {
+ mdbx_free(mc);
+ return rc;
+ }
+ if (txn->mt_cursors) {
+ mc->mc_next = txn->mt_cursors[dbi];
+ txn->mt_cursors[dbi] = mc;
+ mc->mc_flags |= C_UNTRACK;
+ }
+ } else {
+ return MDBX_ENOMEM;
+ }
+
+ *ret = mc;
+ return MDBX_SUCCESS;
+}
+
+int mdbx_cursor_renew(MDBX_txn *txn, MDBX_cursor *mc) {
+ if (unlikely(!mc))
+ return MDBX_EINVAL;
+
+ if (unlikely(mc->mc_signature != MDBX_MC_SIGNATURE &&
+ mc->mc_signature != MDBX_MC_READY4CLOSE))
+ return MDBX_EINVAL;
+
+ int rc = check_txn(mc->mc_txn, MDBX_TXN_BLOCKED);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ if (unlikely(!TXN_DBI_EXIST(txn, mc->mc_dbi, DB_VALID)))
+ return MDBX_EINVAL;
+
+ if (unlikely(mc->mc_backup))
+ return MDBX_EINVAL;
+
+ if (unlikely((mc->mc_flags & C_UNTRACK) || txn->mt_cursors)) {
+ MDBX_cursor **prev = &mc->mc_txn->mt_cursors[mc->mc_dbi];
+ while (*prev && *prev != mc)
+ prev = &(*prev)->mc_next;
+ if (*prev == mc)
+ *prev = mc->mc_next;
+ mc->mc_signature = MDBX_MC_READY4CLOSE;
+ }
+
+ if (unlikely(txn->mt_flags & MDBX_TXN_BLOCKED))
+ return MDBX_BAD_TXN;
+
+ return mdbx_cursor_init(mc, txn, mc->mc_dbi);
+}
+
+/* Return the count of duplicate data items for the current key */
+int mdbx_cursor_count(MDBX_cursor *mc, size_t *countp) {
+ if (unlikely(mc == NULL))
+ return MDBX_EINVAL;
+
+ if (unlikely(mc->mc_signature != MDBX_MC_SIGNATURE))
+ return MDBX_EBADSIGN;
+
+ int rc = check_txn(mc->mc_txn, MDBX_TXN_BLOCKED);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ if (unlikely(countp == NULL || !(mc->mc_flags & C_INITIALIZED)))
+ return MDBX_EINVAL;
+
+ if (!mc->mc_snum) {
+ *countp = 0;
+ return MDBX_NOTFOUND;
+ }
+
+ MDBX_page *mp = mc->mc_pg[mc->mc_top];
+ if ((mc->mc_flags & C_EOF) && mc->mc_ki[mc->mc_top] >= page_numkeys(mp)) {
+ *countp = 0;
+ return MDBX_NOTFOUND;
+ }
+
+ *countp = 1;
+ if (mc->mc_xcursor != NULL) {
+ MDBX_node *node = page_node(mp, mc->mc_ki[mc->mc_top]);
+ if (F_ISSET(node_flags(node), F_DUPDATA)) {
+ mdbx_cassert(mc, mc->mc_xcursor && (mc->mc_xcursor->mx_cursor.mc_flags &
+ C_INITIALIZED));
+ *countp = unlikely(mc->mc_xcursor->mx_db.md_entries > PTRDIFF_MAX)
+ ? PTRDIFF_MAX
+ : (size_t)mc->mc_xcursor->mx_db.md_entries;
+ }
+ }
+ return MDBX_SUCCESS;
+}
+
+void mdbx_cursor_close(MDBX_cursor *mc) {
+ if (mc) {
+ mdbx_ensure(NULL, mc->mc_signature == MDBX_MC_SIGNATURE ||
+ mc->mc_signature == MDBX_MC_READY4CLOSE);
+ if (!mc->mc_backup) {
+ /* Remove from txn, if tracked.
+ * A read-only txn (!C_UNTRACK) may have been freed already,
+ * so do not peek inside it. Only write txns track cursors. */
+ if ((mc->mc_flags & C_UNTRACK) && mc->mc_txn->mt_cursors) {
+ MDBX_cursor **prev = &mc->mc_txn->mt_cursors[mc->mc_dbi];
+ while (*prev && *prev != mc)
+ prev = &(*prev)->mc_next;
+ if (*prev == mc)
+ *prev = mc->mc_next;
+ }
+ mc->mc_signature = 0;
+ mdbx_free(mc);
+ } else {
+ /* cursor closed before nested txn ends */
+ mdbx_cassert(mc, mc->mc_signature == MDBX_MC_SIGNATURE);
+ mc->mc_signature = MDBX_MC_WAIT4EOT;
+ }
+ }
+}
+
+MDBX_txn *mdbx_cursor_txn(MDBX_cursor *mc) {
+ if (unlikely(!mc || mc->mc_signature != MDBX_MC_SIGNATURE))
+ return NULL;
+ MDBX_txn *txn = mc->mc_txn;
+ if (unlikely(!txn || txn->mt_signature != MDBX_MT_SIGNATURE))
+ return NULL;
+ if (unlikely(txn->mt_flags & MDBX_TXN_FINISHED))
+ return NULL;
+ return txn;
+}
+
+MDBX_dbi mdbx_cursor_dbi(MDBX_cursor *mc) {
+ if (unlikely(!mc || mc->mc_signature != MDBX_MC_SIGNATURE))
+ return UINT_MAX;
+ return mc->mc_dbi;
+}
+
+/* Replace the key for a branch node with a new key.
+ * Set MDBX_TXN_ERROR on failure.
+ * [in] mc Cursor pointing to the node to operate on.
+ * [in] key The new key to use.
+ * Returns 0 on success, non-zero on failure. */
+static int mdbx_update_key(MDBX_cursor *mc, const MDBX_val *key) {
+ MDBX_page *mp;
+ MDBX_node *node;
+ char *base;
+ size_t len;
+ int delta, ksize, oksize;
+ int ptr, i, nkeys, indx;
+ DKBUF;
+
+ indx = mc->mc_ki[mc->mc_top];
+ mp = mc->mc_pg[mc->mc_top];
+ node = page_node(mp, indx);
+ ptr = mp->mp_ptrs[indx];
+ if (MDBX_DEBUG) {
+ MDBX_val k2;
+ char kbuf2[DKBUF_MAXKEYSIZE * 2 + 1];
+ k2.iov_base = node_key(node);
+ k2.iov_len = node_ks(node);
+ mdbx_debug("update key %u (ofs %u) [%s] to [%s] on page %" PRIaPGNO, indx,
+ ptr, mdbx_dump_val(&k2, kbuf2, sizeof(kbuf2)), DKEY(key),
+ mp->mp_pgno);
+ }
+
+ /* Sizes must be 2-byte aligned. */
+ ksize = EVEN(key->iov_len);
+ oksize = EVEN(node_ks(node));
+ delta = ksize - oksize;
+
+ /* Shift node contents if EVEN(key length) changed. */
+ if (delta) {
+ if (delta > (int)page_room(mp)) {
+ /* not enough space left, do a delete and split */
+ mdbx_debug("Not enough room, delta = %d, splitting...", delta);
+ pgno_t pgno = node_pgno(node);
+ mdbx_node_del(mc, 0);
+ int rc = mdbx_page_split(mc, key, NULL, pgno, MDBX_SPLIT_REPLACE);
+ if (rc == MDBX_SUCCESS && mdbx_audit_enabled())
+ rc = mdbx_cursor_check(mc, true);
+ return rc;
+ }
+
+ nkeys = page_numkeys(mp);
+ for (i = 0; i < nkeys; i++) {
+ if (mp->mp_ptrs[i] <= ptr) {
+ mdbx_cassert(mc, mp->mp_ptrs[i] >= delta);
+ mp->mp_ptrs[i] -= (indx_t)delta;
+ }
+ }
+
+ base = (char *)mp + mp->mp_upper + PAGEHDRSZ;
+ len = ptr - mp->mp_upper + NODESIZE;
+ memmove(base - delta, base, len);
+ mdbx_cassert(mc, mp->mp_upper >= delta);
+ mp->mp_upper -= (indx_t)delta;
+
+ node = page_node(mp, indx);
+ }
+
+ /* But even if no shift was needed, update ksize */
+ node_set_ks(node, key->iov_len);
+
+ if (key->iov_len)
+ memcpy(node_key(node), key->iov_base, key->iov_len);
+ return MDBX_SUCCESS;
+}
+
+/* Move a node from csrc to cdst. */
+static int mdbx_node_move(MDBX_cursor *csrc, MDBX_cursor *cdst, int fromleft) {
+ int rc;
+ DKBUF;
+
+ MDBX_page *psrc = csrc->mc_pg[csrc->mc_top];
+ MDBX_page *pdst = cdst->mc_pg[cdst->mc_top];
+ mdbx_cassert(csrc, PAGETYPE(psrc) == PAGETYPE(pdst));
+ mdbx_cassert(csrc, csrc->mc_dbi == cdst->mc_dbi);
+ mdbx_cassert(csrc, csrc->mc_top == cdst->mc_top);
+ if (unlikely(PAGETYPE(psrc) != PAGETYPE(pdst))) {
+ bailout:
+ csrc->mc_txn->mt_flags |= MDBX_TXN_ERROR;
+ return MDBX_PROBLEM;
+ }
+
+ MDBX_val key4move;
+ switch (PAGETYPE(psrc)) {
+ case P_BRANCH: {
+ const MDBX_node *srcnode = page_node(psrc, csrc->mc_ki[csrc->mc_top]);
+ mdbx_cassert(csrc, node_flags(srcnode) == 0);
+ const pgno_t srcpg = node_pgno(srcnode);
+ key4move.iov_len = node_ks(srcnode);
+ key4move.iov_base = node_key(srcnode);
+
+ if (csrc->mc_ki[csrc->mc_top] == 0) {
+ const uint16_t snum = csrc->mc_snum;
+ mdbx_cassert(csrc, snum > 0);
+ /* must find the lowest key below src */
+ rc = mdbx_page_search_lowest(csrc);
+ MDBX_page *lowest_page = csrc->mc_pg[csrc->mc_top];
+ if (unlikely(rc))
+ return rc;
+ mdbx_cassert(csrc, IS_LEAF(lowest_page));
+ if (unlikely(!IS_LEAF(lowest_page)))
+ goto bailout;
+ if (IS_LEAF2(lowest_page)) {
+ key4move.iov_len = csrc->mc_db->md_xsize;
+ key4move.iov_base = page_leaf2key(lowest_page, 0, key4move.iov_len);
+ } else {
+ const MDBX_node *lowest_node = page_node(lowest_page, 0);
+ key4move.iov_len = node_ks(lowest_node);
+ key4move.iov_base = node_key(lowest_node);
+ }
+
+ /* restore cursor after mdbx_page_search_lowest() */
+ csrc->mc_snum = snum;
+ csrc->mc_top = snum - 1;
+ csrc->mc_ki[csrc->mc_top] = 0;
+
+ /* paranoia */
+ mdbx_cassert(csrc, psrc == csrc->mc_pg[csrc->mc_top]);
+ mdbx_cassert(csrc, IS_BRANCH(psrc));
+ if (unlikely(!IS_BRANCH(psrc)))
+ goto bailout;
+ }
+
+ if (cdst->mc_ki[cdst->mc_top] == 0) {
+ const uint16_t snum = cdst->mc_snum;
+ mdbx_cassert(csrc, snum > 0);
+ MDBX_cursor mn;
+ mdbx_cursor_copy(cdst, &mn);
+ mn.mc_xcursor = NULL;
+ /* must find the lowest key below dst */
+ rc = mdbx_page_search_lowest(&mn);
+ if (unlikely(rc))
+ return rc;
+ MDBX_page *const lowest_page = mn.mc_pg[mn.mc_top];
+ mdbx_cassert(cdst, IS_LEAF(lowest_page));
+ if (unlikely(!IS_LEAF(lowest_page)))
+ goto bailout;
+ MDBX_val key;
+ if (IS_LEAF2(lowest_page)) {
+ key.iov_len = mn.mc_db->md_xsize;
+ key.iov_base = page_leaf2key(lowest_page, 0, key.iov_len);
+ } else {
+ MDBX_node *lowest_node = page_node(lowest_page, 0);
+ key.iov_len = node_ks(lowest_node);
+ key.iov_base = node_key(lowest_node);
+ }
+
+ /* restore cursor after mdbx_page_search_lowest() */
+ mn.mc_snum = snum;
+ mn.mc_top = snum - 1;
+ mn.mc_ki[mn.mc_top] = 0;
+
+ const intptr_t delta =
+ EVEN(key.iov_len) - EVEN(node_ks(page_node(mn.mc_pg[mn.mc_top], 0)));
+ const intptr_t needed =
+ branch_size(cdst->mc_txn->mt_env, &key4move) + delta;
+ const intptr_t have = page_room(pdst);
+ if (unlikely(needed > have))
+ return MDBX_RESULT_TRUE;
+
+ if (unlikely((rc = mdbx_page_touch(csrc)) ||
+ (rc = mdbx_page_touch(cdst))))
+ return rc;
+ psrc = csrc->mc_pg[csrc->mc_top];
+ pdst = cdst->mc_pg[cdst->mc_top];
+
+ rc = mdbx_update_key(&mn, &key);
+ if (unlikely(rc))
+ return rc;
+ } else {
+ const size_t needed = branch_size(cdst->mc_txn->mt_env, &key4move);
+ const size_t have = page_room(pdst);
+ if (unlikely(needed > have))
+ return MDBX_RESULT_TRUE;
+
+ if (unlikely((rc = mdbx_page_touch(csrc)) ||
+ (rc = mdbx_page_touch(cdst))))
+ return rc;
+ psrc = csrc->mc_pg[csrc->mc_top];
+ pdst = cdst->mc_pg[cdst->mc_top];
+ }
+
+ mdbx_debug("moving %s-node %u [%s] on page %" PRIaPGNO
+ " to node %u on page %" PRIaPGNO,
+ "branch", csrc->mc_ki[csrc->mc_top], DKEY(&key4move),
+ psrc->mp_pgno, cdst->mc_ki[cdst->mc_top], pdst->mp_pgno);
+ /* Add the node to the destination page. */
+ rc =
+ mdbx_node_add_branch(cdst, cdst->mc_ki[cdst->mc_top], &key4move, srcpg);
+ } break;
+
+ case P_LEAF: {
+ /* Mark src and dst as dirty. */
+ if (unlikely((rc = mdbx_page_touch(csrc)) || (rc = mdbx_page_touch(cdst))))
+ return rc;
+ psrc = csrc->mc_pg[csrc->mc_top];
+ pdst = cdst->mc_pg[cdst->mc_top];
+ const MDBX_node *srcnode = page_node(psrc, csrc->mc_ki[csrc->mc_top]);
+ MDBX_val data;
+ data.iov_len = node_ds(srcnode);
+ data.iov_base = node_data(srcnode);
+ key4move.iov_len = node_ks(srcnode);
+ key4move.iov_base = node_key(srcnode);
+ mdbx_debug("moving %s-node %u [%s] on page %" PRIaPGNO
+ " to node %u on page %" PRIaPGNO,
+ "leaf", csrc->mc_ki[csrc->mc_top], DKEY(&key4move),
+ psrc->mp_pgno, cdst->mc_ki[cdst->mc_top], pdst->mp_pgno);
+ /* Add the node to the destination page. */
+ rc = mdbx_node_add_leaf(cdst, cdst->mc_ki[cdst->mc_top], &key4move, &data,
+ node_flags(srcnode));
+ } break;
+
+ case P_LEAF | P_LEAF2: {
+ /* Mark src and dst as dirty. */
+ if (unlikely((rc = mdbx_page_touch(csrc)) || (rc = mdbx_page_touch(cdst))))
+ return rc;
+ psrc = csrc->mc_pg[csrc->mc_top];
+ pdst = cdst->mc_pg[cdst->mc_top];
+ key4move.iov_len = csrc->mc_db->md_xsize;
+ key4move.iov_base =
+ page_leaf2key(psrc, csrc->mc_ki[csrc->mc_top], key4move.iov_len);
+ mdbx_debug("moving %s-node %u [%s] on page %" PRIaPGNO
+ " to node %u on page %" PRIaPGNO,
+ "leaf2", csrc->mc_ki[csrc->mc_top], DKEY(&key4move),
+ psrc->mp_pgno, cdst->mc_ki[cdst->mc_top], pdst->mp_pgno);
+ /* Add the node to the destination page. */
+ rc = mdbx_node_add_leaf2(cdst, cdst->mc_ki[cdst->mc_top], &key4move);
+ } break;
+
+ default:
+ goto bailout;
+ }
+
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ /* Delete the node from the source page. */
+ mdbx_node_del(csrc, key4move.iov_len);
+
+ mdbx_cassert(csrc, psrc == csrc->mc_pg[csrc->mc_top]);
+ mdbx_cassert(cdst, pdst == cdst->mc_pg[cdst->mc_top]);
+ mdbx_cassert(csrc, PAGETYPE(psrc) == PAGETYPE(pdst));
+
+ {
+ /* Adjust other cursors pointing to mp */
+ MDBX_cursor *m2, *m3;
+ const MDBX_dbi dbi = csrc->mc_dbi;
+ mdbx_cassert(csrc, csrc->mc_top == cdst->mc_top);
+ if (fromleft) {
+ /* If we're adding on the left, bump others up */
+ for (m2 = csrc->mc_txn->mt_cursors[dbi]; m2; m2 = m2->mc_next) {
+ m3 = (csrc->mc_flags & C_SUB) ? &m2->mc_xcursor->mx_cursor : m2;
+ if (!(m3->mc_flags & C_INITIALIZED) || m3->mc_top < csrc->mc_top)
+ continue;
+ if (m3 != cdst && m3->mc_pg[csrc->mc_top] == pdst &&
+ m3->mc_ki[csrc->mc_top] >= cdst->mc_ki[csrc->mc_top]) {
+ m3->mc_ki[csrc->mc_top]++;
+ }
+ if (m3 != csrc && m3->mc_pg[csrc->mc_top] == psrc &&
+ m3->mc_ki[csrc->mc_top] == csrc->mc_ki[csrc->mc_top]) {
+ m3->mc_pg[csrc->mc_top] = pdst;
+ m3->mc_ki[csrc->mc_top] = cdst->mc_ki[cdst->mc_top];
+ mdbx_cassert(csrc, csrc->mc_top > 0);
+ m3->mc_ki[csrc->mc_top - 1]++;
+ }
+ if (XCURSOR_INITED(m3) && IS_LEAF(psrc))
+ XCURSOR_REFRESH(m3, m3->mc_pg[csrc->mc_top], m3->mc_ki[csrc->mc_top]);
+ }
+ } else {
+ /* Adding on the right, bump others down */
+ for (m2 = csrc->mc_txn->mt_cursors[dbi]; m2; m2 = m2->mc_next) {
+ m3 = (csrc->mc_flags & C_SUB) ? &m2->mc_xcursor->mx_cursor : m2;
+ if (m3 == csrc)
+ continue;
+ if (!(m3->mc_flags & C_INITIALIZED) || m3->mc_top < csrc->mc_top)
+ continue;
+ if (m3->mc_pg[csrc->mc_top] == psrc) {
+ if (!m3->mc_ki[csrc->mc_top]) {
+ m3->mc_pg[csrc->mc_top] = pdst;
+ m3->mc_ki[csrc->mc_top] = cdst->mc_ki[cdst->mc_top];
+ mdbx_cassert(csrc, csrc->mc_top > 0);
+ m3->mc_ki[csrc->mc_top - 1]--;
+ } else {
+ m3->mc_ki[csrc->mc_top]--;
+ }
+ if (XCURSOR_INITED(m3) && IS_LEAF(psrc))
+ XCURSOR_REFRESH(m3, m3->mc_pg[csrc->mc_top],
+ m3->mc_ki[csrc->mc_top]);
+ }
+ }
+ }
+ }
+
+ /* Update the parent separators. */
+ if (csrc->mc_ki[csrc->mc_top] == 0) {
+ mdbx_cassert(csrc, csrc->mc_top > 0);
+ if (csrc->mc_ki[csrc->mc_top - 1] != 0) {
+ MDBX_val key;
+ if (IS_LEAF2(psrc)) {
+ key.iov_len = psrc->mp_leaf2_ksize;
+ key.iov_base = page_leaf2key(psrc, 0, key.iov_len);
+ } else {
+ MDBX_node *srcnode = page_node(psrc, 0);
+ key.iov_len = node_ks(srcnode);
+ key.iov_base = node_key(srcnode);
+ }
+ mdbx_debug("update separator for source page %" PRIaPGNO " to [%s]",
+ psrc->mp_pgno, DKEY(&key));
+ MDBX_cursor mn;
+ mdbx_cursor_copy(csrc, &mn);
+ mn.mc_xcursor = NULL;
+ mdbx_cassert(csrc, mn.mc_snum > 0);
+ mn.mc_snum--;
+ mn.mc_top--;
+ /* We want mdbx_rebalance to find mn when doing fixups */
+ WITH_CURSOR_TRACKING(mn, rc = mdbx_update_key(&mn, &key));
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+ }
+ if (IS_BRANCH(psrc)) {
+ const MDBX_val nullkey = {0, 0};
+ const indx_t ix = csrc->mc_ki[csrc->mc_top];
+ csrc->mc_ki[csrc->mc_top] = 0;
+ rc = mdbx_update_key(csrc, &nullkey);
+ csrc->mc_ki[csrc->mc_top] = ix;
+ mdbx_cassert(csrc, rc == MDBX_SUCCESS);
+ }
+ }
+
+ if (cdst->mc_ki[cdst->mc_top] == 0) {
+ mdbx_cassert(cdst, cdst->mc_top > 0);
+ if (cdst->mc_ki[cdst->mc_top - 1] != 0) {
+ MDBX_val key;
+ if (IS_LEAF2(pdst)) {
+ key.iov_len = pdst->mp_leaf2_ksize;
+ key.iov_base = page_leaf2key(pdst, 0, key.iov_len);
+ } else {
+ MDBX_node *srcnode = page_node(pdst, 0);
+ key.iov_len = node_ks(srcnode);
+ key.iov_base = node_key(srcnode);
+ }
+ mdbx_debug("update separator for destination page %" PRIaPGNO " to [%s]",
+ pdst->mp_pgno, DKEY(&key));
+ MDBX_cursor mn;
+ mdbx_cursor_copy(cdst, &mn);
+ mn.mc_xcursor = NULL;
+ mdbx_cassert(cdst, mn.mc_snum > 0);
+ mn.mc_snum--;
+ mn.mc_top--;
+ /* We want mdbx_rebalance to find mn when doing fixups */
+ WITH_CURSOR_TRACKING(mn, rc = mdbx_update_key(&mn, &key));
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+ }
+ if (IS_BRANCH(pdst)) {
+ const MDBX_val nullkey = {0, 0};
+ const indx_t ix = cdst->mc_ki[cdst->mc_top];
+ cdst->mc_ki[cdst->mc_top] = 0;
+ rc = mdbx_update_key(cdst, &nullkey);
+ cdst->mc_ki[cdst->mc_top] = ix;
+ mdbx_cassert(cdst, rc == MDBX_SUCCESS);
+ }
+ }
+
+ return MDBX_SUCCESS;
+}
+
+/* Merge one page into another.
+ *
+ * The nodes from the page pointed to by csrc will be copied to the page
+ * pointed to by cdst and then the csrc page will be freed.
+ *
+ * [in] csrc Cursor pointing to the source page.
+ * [in] cdst Cursor pointing to the destination page.
+ *
+ * Returns 0 on success, non-zero on failure. */
+static int mdbx_page_merge(MDBX_cursor *csrc, MDBX_cursor *cdst) {
+ MDBX_val key;
+ int rc;
+
+ mdbx_cassert(csrc, csrc != cdst);
+ const MDBX_page *const psrc = csrc->mc_pg[csrc->mc_top];
+ MDBX_page *pdst = cdst->mc_pg[cdst->mc_top];
+ mdbx_debug("merging page %" PRIaPGNO " into %" PRIaPGNO, psrc->mp_pgno,
+ pdst->mp_pgno);
+
+ mdbx_cassert(csrc, PAGETYPE(psrc) == PAGETYPE(pdst));
+ mdbx_cassert(csrc,
+ csrc->mc_dbi == cdst->mc_dbi && csrc->mc_db == cdst->mc_db);
+ mdbx_cassert(csrc, csrc->mc_snum > 1); /* can't merge root page */
+ mdbx_cassert(cdst, cdst->mc_snum > 1);
+ mdbx_cassert(cdst, cdst->mc_snum < cdst->mc_db->md_depth ||
+ IS_LEAF(cdst->mc_pg[cdst->mc_db->md_depth - 1]));
+ mdbx_cassert(csrc, csrc->mc_snum < csrc->mc_db->md_depth ||
+ IS_LEAF(csrc->mc_pg[csrc->mc_db->md_depth - 1]));
+ mdbx_cassert(cdst, page_room(pdst) >= page_used(cdst->mc_txn->mt_env, psrc));
+ const int pagetype = PAGETYPE(psrc);
+
+ /* Move all nodes from src to dst */
+ const unsigned dst_nkeys = page_numkeys(pdst);
+ const unsigned src_nkeys = page_numkeys(psrc);
+ if (likely(src_nkeys)) {
+ unsigned j = dst_nkeys;
+ if (unlikely(pagetype & P_LEAF2)) {
+ /* Mark dst as dirty. */
+ if (unlikely(rc = mdbx_page_touch(cdst)))
+ return rc;
+
+ key.iov_len = csrc->mc_db->md_xsize;
+ key.iov_base = page_data(psrc);
+ unsigned i = 0;
+ do {
+ rc = mdbx_node_add_leaf2(cdst, j++, &key);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+ key.iov_base = (char *)key.iov_base + key.iov_len;
+ } while (++i != src_nkeys);
+ } else {
+ MDBX_node *srcnode = page_node(psrc, 0);
+ key.iov_len = node_ks(srcnode);
+ key.iov_base = node_key(srcnode);
+ if (pagetype & P_BRANCH) {
+ MDBX_cursor mn;
+ mdbx_cursor_copy(csrc, &mn);
+ mn.mc_xcursor = NULL;
+ /* must find the lowest key below src */
+ rc = mdbx_page_search_lowest(&mn);
+ if (unlikely(rc))
+ return rc;
+ if (IS_LEAF2(mn.mc_pg[mn.mc_top])) {
+ key.iov_len = mn.mc_db->md_xsize;
+ key.iov_base = page_leaf2key(mn.mc_pg[mn.mc_top], 0, key.iov_len);
+ } else {
+ MDBX_node *lowest = page_node(mn.mc_pg[mn.mc_top], 0);
+ key.iov_len = node_ks(lowest);
+ key.iov_base = node_key(lowest);
+
+ const size_t dst_room = page_room(pdst);
+ const size_t src_used = page_used(cdst->mc_txn->mt_env, psrc);
+ const size_t space_needed = src_used - node_ks(srcnode) + key.iov_len;
+ if (unlikely(space_needed > dst_room))
+ return MDBX_RESULT_TRUE;
+ }
+ }
+
+ /* Mark dst as dirty. */
+ if (unlikely(rc = mdbx_page_touch(cdst)))
+ return rc;
+
+ unsigned i = 0;
+ while (true) {
+ if (pagetype & P_LEAF) {
+ MDBX_val data;
+ data.iov_len = node_ds(srcnode);
+ data.iov_base = node_data(srcnode);
+ rc = mdbx_node_add_leaf(cdst, j++, &key, &data, node_flags(srcnode));
+ } else {
+ mdbx_cassert(csrc, node_flags(srcnode) == 0);
+ rc = mdbx_node_add_branch(cdst, j++, &key, node_pgno(srcnode));
+ }
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ if (++i == src_nkeys)
+ break;
+ srcnode = page_node(psrc, i);
+ key.iov_len = node_ks(srcnode);
+ key.iov_base = node_key(srcnode);
+ }
+ }
+
+ pdst = cdst->mc_pg[cdst->mc_top];
+ mdbx_debug("dst page %" PRIaPGNO " now has %u keys (%.1f%% filled)",
+ pdst->mp_pgno, page_numkeys(pdst),
+ page_fill(cdst->mc_txn->mt_env, pdst));
+
+ mdbx_cassert(csrc, psrc == csrc->mc_pg[csrc->mc_top]);
+ mdbx_cassert(cdst, pdst == cdst->mc_pg[cdst->mc_top]);
+ }
+
+ /* Unlink the src page from parent and add to free list. */
+ csrc->mc_top--;
+ mdbx_node_del(csrc, 0);
+ if (csrc->mc_ki[csrc->mc_top] == 0) {
+ const MDBX_val nullkey = {0, 0};
+ rc = mdbx_update_key(csrc, &nullkey);
+ if (unlikely(rc)) {
+ csrc->mc_top++;
+ return rc;
+ }
+ }
+ csrc->mc_top++;
+
+ mdbx_cassert(csrc, psrc == csrc->mc_pg[csrc->mc_top]);
+ mdbx_cassert(cdst, pdst == cdst->mc_pg[cdst->mc_top]);
+
+ {
+ /* Adjust other cursors pointing to mp */
+ MDBX_cursor *m2, *m3;
+ const MDBX_dbi dbi = csrc->mc_dbi;
+ const unsigned top = csrc->mc_top;
+
+ for (m2 = csrc->mc_txn->mt_cursors[dbi]; m2; m2 = m2->mc_next) {
+ m3 = (csrc->mc_flags & C_SUB) ? &m2->mc_xcursor->mx_cursor : m2;
+ if (m3 == csrc || top >= m3->mc_snum)
+ continue;
+ if (m3->mc_pg[top] == psrc) {
+ m3->mc_pg[top] = pdst;
+ mdbx_cassert(m3, dst_nkeys + m3->mc_ki[top] <= UINT16_MAX);
+ m3->mc_ki[top] += (indx_t)dst_nkeys;
+ m3->mc_ki[top - 1] = cdst->mc_ki[top - 1];
+ } else if (m3->mc_pg[top - 1] == csrc->mc_pg[top - 1] &&
+ m3->mc_ki[top - 1] > csrc->mc_ki[top - 1]) {
+ m3->mc_ki[top - 1]--;
+ }
+ if (XCURSOR_INITED(m3) && IS_LEAF(psrc))
+ XCURSOR_REFRESH(m3, m3->mc_pg[top], m3->mc_ki[top]);
+ }
+ }
+
+ /* If not operating on GC, allow this page to be reused
+ * in this txn. Otherwise just add to free list. */
+ rc = mdbx_page_retire(csrc, (MDBX_page *)psrc);
+ if (unlikely(rc))
+ return rc;
+
+ mdbx_cassert(cdst, cdst->mc_db->md_entries > 0);
+ mdbx_cassert(cdst, cdst->mc_snum <= cdst->mc_db->md_depth);
+ mdbx_cassert(cdst, cdst->mc_top > 0);
+ mdbx_cassert(cdst, cdst->mc_snum == cdst->mc_top + 1);
+ MDBX_page *const top_page = cdst->mc_pg[cdst->mc_top];
+ const indx_t top_indx = cdst->mc_ki[cdst->mc_top];
+ const uint16_t save_snum = cdst->mc_snum;
+ const uint16_t save_depth = cdst->mc_db->md_depth;
+ mdbx_cursor_pop(cdst);
+ rc = mdbx_rebalance(cdst);
+ if (unlikely(rc))
+ return rc;
+
+ mdbx_cassert(cdst, cdst->mc_db->md_entries > 0);
+ mdbx_cassert(cdst, cdst->mc_snum <= cdst->mc_db->md_depth);
+ mdbx_cassert(cdst, cdst->mc_snum == cdst->mc_top + 1);
+
+ if (IS_LEAF(cdst->mc_pg[cdst->mc_top])) {
+ /* LY: don't touch cursor if top-page is a LEAF */
+ mdbx_cassert(cdst, IS_LEAF(cdst->mc_pg[cdst->mc_top]) ||
+ PAGETYPE(cdst->mc_pg[cdst->mc_top]) == pagetype);
+ return MDBX_SUCCESS;
+ }
+
+ if (pagetype != PAGETYPE(top_page)) {
+ /* LY: LEAF-page becomes BRANCH, unable restore cursor's stack */
+ goto bailout;
+ }
+
+ if (top_page == cdst->mc_pg[cdst->mc_top]) {
+ /* LY: don't touch cursor if prev top-page already on the top */
+ mdbx_cassert(cdst, cdst->mc_ki[cdst->mc_top] == top_indx);
+ mdbx_cassert(cdst, IS_LEAF(cdst->mc_pg[cdst->mc_top]) ||
+ PAGETYPE(cdst->mc_pg[cdst->mc_top]) == pagetype);
+ return MDBX_SUCCESS;
+ }
+
+ const int new_snum = save_snum - save_depth + cdst->mc_db->md_depth;
+ if (unlikely(new_snum < 1 || new_snum > cdst->mc_db->md_depth)) {
+ /* LY: out of range, unable restore cursor's stack */
+ goto bailout;
+ }
+
+ if (top_page == cdst->mc_pg[new_snum - 1]) {
+ mdbx_cassert(cdst, cdst->mc_ki[new_snum - 1] == top_indx);
+ /* LY: restore cursor stack */
+ cdst->mc_snum = (uint16_t)new_snum;
+ cdst->mc_top = (uint16_t)new_snum - 1;
+ mdbx_cassert(cdst, cdst->mc_snum < cdst->mc_db->md_depth ||
+ IS_LEAF(cdst->mc_pg[cdst->mc_db->md_depth - 1]));
+ mdbx_cassert(cdst, IS_LEAF(cdst->mc_pg[cdst->mc_top]) ||
+ PAGETYPE(cdst->mc_pg[cdst->mc_top]) == pagetype);
+ return MDBX_SUCCESS;
+ }
+
+ MDBX_page *const stub_page = (MDBX_page *)(~(uintptr_t)top_page);
+ const indx_t stub_indx = top_indx;
+ if (save_depth > cdst->mc_db->md_depth &&
+ ((cdst->mc_pg[save_snum - 1] == top_page &&
+ cdst->mc_ki[save_snum - 1] == top_indx) ||
+ (cdst->mc_pg[save_snum - 1] == stub_page &&
+ cdst->mc_ki[save_snum - 1] == stub_indx))) {
+ /* LY: restore cursor stack */
+ cdst->mc_pg[new_snum - 1] = top_page;
+ cdst->mc_ki[new_snum - 1] = top_indx;
+ cdst->mc_pg[new_snum] = (MDBX_page *)(~(uintptr_t)cdst->mc_pg[new_snum]);
+ cdst->mc_ki[new_snum] = ~cdst->mc_ki[new_snum];
+ cdst->mc_snum = (uint16_t)new_snum;
+ cdst->mc_top = (uint16_t)new_snum - 1;
+ mdbx_cassert(cdst, cdst->mc_snum < cdst->mc_db->md_depth ||
+ IS_LEAF(cdst->mc_pg[cdst->mc_db->md_depth - 1]));
+ mdbx_cassert(cdst, IS_LEAF(cdst->mc_pg[cdst->mc_top]) ||
+ PAGETYPE(cdst->mc_pg[cdst->mc_top]) == pagetype);
+ return MDBX_SUCCESS;
+ }
+
+bailout:
+ /* LY: unable restore cursor's stack */
+ cdst->mc_flags &= ~C_INITIALIZED;
+ return MDBX_CURSOR_FULL;
+}
+
+/* Copy the contents of a cursor.
+ * [in] csrc The cursor to copy from.
+ * [out] cdst The cursor to copy to. */
+static void mdbx_cursor_copy(const MDBX_cursor *csrc, MDBX_cursor *cdst) {
+ unsigned i;
+
+ mdbx_cassert(csrc,
+ csrc->mc_txn->mt_txnid >= *csrc->mc_txn->mt_env->me_oldest);
+ cdst->mc_txn = csrc->mc_txn;
+ cdst->mc_dbi = csrc->mc_dbi;
+ cdst->mc_db = csrc->mc_db;
+ cdst->mc_dbx = csrc->mc_dbx;
+ cdst->mc_snum = csrc->mc_snum;
+ cdst->mc_top = csrc->mc_top;
+ cdst->mc_flags = csrc->mc_flags;
+
+ for (i = 0; i < csrc->mc_snum; i++) {
+ cdst->mc_pg[i] = csrc->mc_pg[i];
+ cdst->mc_ki[i] = csrc->mc_ki[i];
+ }
+}
+
+/* Rebalance the tree after a delete operation.
+ * [in] mc Cursor pointing to the page where rebalancing should begin.
+ * Returns 0 on success, non-zero on failure. */
+static int mdbx_rebalance(MDBX_cursor *mc) {
+ int rc;
+
+ mdbx_cassert(mc, mc->mc_snum > 0);
+ mdbx_cassert(mc, mc->mc_snum < mc->mc_db->md_depth ||
+ IS_LEAF(mc->mc_pg[mc->mc_db->md_depth - 1]));
+ const int pagetype = PAGETYPE(mc->mc_pg[mc->mc_top]);
+
+ const unsigned minkeys = (P_BRANCH == 1) ? (pagetype & P_BRANCH) + 1
+ : (pagetype & P_BRANCH) ? 2 : 1;
+
+ /* The threshold of minimum page fill factor, in form of a negative binary
+ * exponent, i.e. 2 means 1/(2**3) == 1/4 == 25%. Pages emptier than this
+ * are candidates for merging. */
+ const unsigned threshold_fill_exp2 = 2;
+
+ /* The threshold of minimum page fill factor, as a number of free bytes on a
+ * page. Pages emptier than this are candidates for merging. */
+ const unsigned spaceleft_threshold =
+ page_space(mc->mc_txn->mt_env) -
+ (page_space(mc->mc_txn->mt_env) >> threshold_fill_exp2);
+
+ mdbx_debug("rebalancing %s page %" PRIaPGNO " (has %u keys, %.1f%% full)",
+ (pagetype & P_LEAF) ? "leaf" : "branch",
+ mc->mc_pg[mc->mc_top]->mp_pgno,
+ page_numkeys(mc->mc_pg[mc->mc_top]),
+ page_fill(mc->mc_txn->mt_env, mc->mc_pg[mc->mc_top]));
+
+ if (page_fill_enough(mc->mc_pg[mc->mc_top], spaceleft_threshold, minkeys)) {
+ mdbx_debug("no need to rebalance page %" PRIaPGNO ", above fill threshold",
+ mc->mc_pg[mc->mc_top]->mp_pgno);
+ mdbx_cassert(mc, mc->mc_db->md_entries > 0);
+ return MDBX_SUCCESS;
+ }
+
+ if (mc->mc_snum < 2) {
+ MDBX_page *const mp = mc->mc_pg[0];
+ const unsigned nkeys = page_numkeys(mp);
+ mdbx_cassert(mc, (mc->mc_db->md_entries == 0) == (nkeys == 0));
+ if (IS_SUBP(mp)) {
+ mdbx_debug("%s", "Can't rebalance a subpage, ignoring");
+ mdbx_cassert(mc, pagetype & P_LEAF);
+ return MDBX_SUCCESS;
+ }
+ if (nkeys == 0) {
+ mdbx_cassert(mc, IS_LEAF(mp));
+ mdbx_debug("%s", "tree is completely empty");
+ mc->mc_db->md_root = P_INVALID;
+ mc->mc_db->md_depth = 0;
+ mdbx_cassert(mc, mc->mc_db->md_branch_pages == 0 &&
+ mc->mc_db->md_overflow_pages == 0 &&
+ mc->mc_db->md_leaf_pages == 1);
+ /* Adjust cursors pointing to mp */
+ const MDBX_dbi dbi = mc->mc_dbi;
+ for (MDBX_cursor *m2 = mc->mc_txn->mt_cursors[dbi]; m2;
+ m2 = m2->mc_next) {
+ MDBX_cursor *m3 =
+ (mc->mc_flags & C_SUB) ? &m2->mc_xcursor->mx_cursor : m2;
+ if (m3 == mc || !(m3->mc_flags & C_INITIALIZED))
+ continue;
+ if (m3->mc_pg[0] == mp) {
+ m3->mc_snum = 0;
+ m3->mc_top = 0;
+ m3->mc_flags &= ~C_INITIALIZED;
+ }
+ }
+ mc->mc_snum = 0;
+ mc->mc_top = 0;
+ mc->mc_flags &= ~C_INITIALIZED;
+
+ rc = mdbx_page_retire(mc, mp);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+ } else if (IS_BRANCH(mp) && nkeys == 1) {
+ mdbx_debug("%s", "collapsing root page!");
+ mc->mc_db->md_root = node_pgno(page_node(mp, 0));
+ rc = mdbx_page_get(mc, mc->mc_db->md_root, &mc->mc_pg[0], NULL);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+ mc->mc_db->md_depth--;
+ mc->mc_ki[0] = mc->mc_ki[1];
+ for (int i = 1; i < mc->mc_db->md_depth; i++) {
+ mc->mc_pg[i] = mc->mc_pg[i + 1];
+ mc->mc_ki[i] = mc->mc_ki[i + 1];
+ }
+
+ /* Adjust other cursors pointing to mp */
+ MDBX_cursor *m2, *m3;
+ MDBX_dbi dbi = mc->mc_dbi;
+ for (m2 = mc->mc_txn->mt_cursors[dbi]; m2; m2 = m2->mc_next) {
+ m3 = (mc->mc_flags & C_SUB) ? &m2->mc_xcursor->mx_cursor : m2;
+ if (m3 == mc || !(m3->mc_flags & C_INITIALIZED))
+ continue;
+ if (m3->mc_pg[0] == mp) {
+ for (int i = 0; i < mc->mc_db->md_depth; i++) {
+ m3->mc_pg[i] = m3->mc_pg[i + 1];
+ m3->mc_ki[i] = m3->mc_ki[i + 1];
+ }
+ m3->mc_snum--;
+ m3->mc_top--;
+ }
+ }
+ mdbx_cassert(mc, IS_LEAF(mc->mc_pg[mc->mc_top]) ||
+ PAGETYPE(mc->mc_pg[mc->mc_top]) == pagetype);
+ mdbx_cassert(mc, mc->mc_snum < mc->mc_db->md_depth ||
+ IS_LEAF(mc->mc_pg[mc->mc_db->md_depth - 1]));
+
+ rc = mdbx_page_retire(mc, mp);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+ } else {
+ mdbx_debug("root page %" PRIaPGNO
+ " doesn't need rebalancing (flags 0x%x)",
+ mp->mp_pgno, mp->mp_flags);
+ }
+ return MDBX_SUCCESS;
+ }
+
+ /* The parent (branch page) must have at least 2 pointers,
+ * otherwise the tree is invalid. */
+ const unsigned pre_top = mc->mc_top - 1;
+ mdbx_cassert(mc, IS_BRANCH(mc->mc_pg[pre_top]));
+ mdbx_cassert(mc, !IS_SUBP(mc->mc_pg[0]));
+ mdbx_cassert(mc, page_numkeys(mc->mc_pg[pre_top]) > 1);
+
+ /* Leaf page fill factor is below the threshold.
+ * Try to move keys from left or right neighbor, or
+ * merge with a neighbor page. */
+
+ /* Find neighbors. */
+ MDBX_cursor mn;
+ mdbx_cursor_copy(mc, &mn);
+ mn.mc_xcursor = NULL;
+
+ MDBX_page *left = nullptr, *right = nullptr;
+ if (mn.mc_ki[pre_top] > 0) {
+ rc = mdbx_page_get(
+ &mn, node_pgno(page_node(mn.mc_pg[pre_top], mn.mc_ki[pre_top] - 1)),
+ &left, NULL);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+ mdbx_cassert(mc, PAGETYPE(left) == PAGETYPE(mc->mc_pg[mc->mc_top]));
+ }
+ if (mn.mc_ki[pre_top] + 1u < page_numkeys(mn.mc_pg[pre_top])) {
+ rc = mdbx_page_get(
+ &mn, node_pgno(page_node(mn.mc_pg[pre_top], mn.mc_ki[pre_top] + 1)),
+ &right, NULL);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+ mdbx_cassert(mc, PAGETYPE(right) == PAGETYPE(mc->mc_pg[mc->mc_top]));
+ }
+
+ int ki = mc->mc_ki[mc->mc_top];
+ bool fromleft;
+ if (!left || (right && page_room(left) < page_room(right))) {
+ mdbx_debug("merging %s neighbor", "right");
+ mn.mc_pg[mn.mc_top] = right;
+ mn.mc_ki[pre_top] += 1;
+ mn.mc_ki[mn.mc_top] = 0;
+ mc->mc_ki[mc->mc_top] = (indx_t)page_numkeys(mc->mc_pg[mc->mc_top]);
+ fromleft = false;
+ } else {
+ mdbx_debug("merging %s neighbor", "left");
+ mn.mc_pg[mn.mc_top] = left;
+ mn.mc_ki[pre_top] -= 1;
+ mn.mc_ki[mn.mc_top] = (indx_t)page_numkeys(mn.mc_pg[mn.mc_top]) - 1;
+ mc->mc_ki[mc->mc_top] = 0;
+ fromleft = true;
+ }
+
+ mdbx_debug("found neighbor page %" PRIaPGNO " (%u keys, %.1f%% full)",
+ mn.mc_pg[mn.mc_top]->mp_pgno, page_numkeys(mn.mc_pg[mn.mc_top]),
+ page_fill(mc->mc_txn->mt_env, mn.mc_pg[mn.mc_top]));
+
+ /* If the neighbor page is above threshold and has enough keys,
+ * move one key from it. Otherwise we should try to merge them.
+ * (A branch page must never have less than 2 keys.) */
+ if (page_fill_enough(mn.mc_pg[mn.mc_top], spaceleft_threshold, minkeys + 1)) {
+ rc = mdbx_node_move(&mn, mc, fromleft);
+ if (likely(rc == MDBX_SUCCESS))
+ ki += fromleft /* if we inserted on left, bump position up */;
+ else if (unlikely(rc != MDBX_RESULT_TRUE))
+ return rc;
+ mdbx_cassert(mc, IS_LEAF(mc->mc_pg[mc->mc_top]) ||
+ PAGETYPE(mc->mc_pg[mc->mc_top]) == pagetype);
+ mdbx_cassert(mc, mc->mc_snum < mc->mc_db->md_depth ||
+ IS_LEAF(mc->mc_pg[mc->mc_db->md_depth - 1]));
+ } else {
+ if (!fromleft) {
+ rc = mdbx_page_merge(&mn, mc);
+ if (unlikely(MDBX_IS_ERROR(rc)))
+ return rc;
+ mdbx_cassert(mc, IS_LEAF(mc->mc_pg[mc->mc_top]) ||
+ PAGETYPE(mc->mc_pg[mc->mc_top]) == pagetype);
+ mdbx_cassert(mc, mc->mc_snum < mc->mc_db->md_depth ||
+ IS_LEAF(mc->mc_pg[mc->mc_db->md_depth - 1]));
+ } else {
+ int new_ki = ki + page_numkeys(mn.mc_pg[mn.mc_top]);
+ mn.mc_ki[mn.mc_top] += mc->mc_ki[mn.mc_top] + 1;
+ /* We want mdbx_rebalance to find mn when doing fixups */
+ WITH_CURSOR_TRACKING(mn, rc = mdbx_page_merge(mc, &mn));
+ if (likely(rc == MDBX_SUCCESS)) {
+ ki = new_ki;
+ mdbx_cursor_copy(&mn, mc);
+ } else if (unlikely(rc != MDBX_RESULT_TRUE))
+ return rc;
+ mdbx_cassert(mc, IS_LEAF(mc->mc_pg[mc->mc_top]) ||
+ PAGETYPE(mc->mc_pg[mc->mc_top]) == pagetype);
+ mdbx_cassert(mc, mc->mc_snum < mc->mc_db->md_depth ||
+ IS_LEAF(mc->mc_pg[mc->mc_db->md_depth - 1]));
+ }
+ }
+ mc->mc_ki[mc->mc_top] = (indx_t)ki;
+ return MDBX_SUCCESS;
+}
+
+static __cold int mdbx_page_check(MDBX_env *env, const MDBX_page *const mp,
+ bool maybe_unfinished) {
+ const unsigned nkeys = page_numkeys(mp);
+ char *const end_of_page = (char *)mp + env->me_psize;
+ mdbx_assert(env, mp->mp_pgno >= MIN_PAGENO && mp->mp_pgno <= MAX_PAGENO);
+ if (unlikely(mp->mp_pgno < MIN_PAGENO || mp->mp_pgno > MAX_PAGENO))
+ return MDBX_CORRUPTED;
+ if (IS_OVERFLOW(mp)) {
+ mdbx_assert(env, mp->mp_pages >= 1 && mp->mp_pages < MAX_PAGENO / 2);
+ if (unlikely(mp->mp_pages < 1 && mp->mp_pages >= MAX_PAGENO / 2))
+ return MDBX_CORRUPTED;
+ mdbx_assert(env, mp->mp_pgno <= MAX_PAGENO - mp->mp_pages);
+ if (unlikely(mp->mp_pgno > MAX_PAGENO - mp->mp_pages))
+ return MDBX_CORRUPTED;
+ return MDBX_SUCCESS;
+ }
+ if (!(IS_DIRTY(mp) && maybe_unfinished)) {
+ mdbx_assert(env, nkeys >= 2 || !IS_BRANCH(mp));
+ if (unlikely(nkeys < 2 && IS_BRANCH(mp)))
+ return MDBX_CORRUPTED;
+ }
+
+ for (unsigned i = IS_LEAF(mp) ? 0 : 1; i < nkeys; ++i) {
+ if (IS_LEAF2(mp)) {
+ const size_t ksize = mp->mp_leaf2_ksize;
+ const char *const key = page_leaf2key(mp, i, ksize);
+ mdbx_assert(env, key + ksize <= end_of_page);
+ if (unlikely(end_of_page < key + ksize))
+ return MDBX_CORRUPTED;
+ } else {
+ const MDBX_node *const node = page_node(mp, i);
+ const char *node_end = (char *)node + NODESIZE;
+ mdbx_assert(env, node_end <= end_of_page);
+ if (unlikely(node_end > end_of_page))
+ return MDBX_CORRUPTED;
+ if (IS_LEAF(mp) || i > 0) {
+ size_t ksize = node_ks(node);
+ char *key = node_key(node);
+ mdbx_assert(env, key + ksize <= end_of_page);
+ if (unlikely(end_of_page < key + ksize))
+ return MDBX_CORRUPTED;
+ }
+ if (IS_BRANCH(mp))
+ continue;
+ if (node_flags(node) == F_BIGDATA /* data on large-page */) {
+ continue;
+ }
+ const size_t dsize = node_ds(node);
+ const char *const data = node_data(node);
+ mdbx_assert(env, data + dsize <= end_of_page);
+ if (unlikely(end_of_page < data + dsize))
+ return MDBX_CORRUPTED;
+
+ switch (node_flags(node)) {
+ default:
+ mdbx_assert(env, false);
+ return MDBX_CORRUPTED;
+ case 0 /* usual */:
+ break;
+ case F_SUBDATA /* sub-db */:
+ mdbx_assert(env, dsize >= sizeof(MDBX_db));
+ if (unlikely(dsize < sizeof(MDBX_db)))
+ return MDBX_CORRUPTED;
+ break;
+ case F_SUBDATA | F_DUPDATA /* dupsorted sub-tree */:
+ mdbx_assert(env, dsize == sizeof(MDBX_db));
+ if (unlikely(dsize != sizeof(MDBX_db)))
+ return MDBX_CORRUPTED;
+ break;
+ case F_DUPDATA /* short sub-page */:
+ mdbx_assert(env, dsize > PAGEHDRSZ);
+ if (unlikely(dsize <= PAGEHDRSZ))
+ return MDBX_CORRUPTED;
+ else {
+ const MDBX_page *const sp = (MDBX_page *)data;
+ const char *const end_of_subpage = data + dsize;
+ const int nsubkeys = page_numkeys(sp);
+ switch (sp->mp_flags & ~P_DIRTY /* ignore for sub-pages */) {
+ case P_LEAF | P_SUBP:
+ case P_LEAF | P_LEAF2 | P_SUBP:
+ break;
+ default:
+ mdbx_assert(env, false);
+ return MDBX_CORRUPTED;
+ }
+
+ for (int j = 0; j < nsubkeys; j++) {
+ if (IS_LEAF2(sp)) {
+ /* LEAF2 pages have no mp_ptrs[] or node headers */
+ size_t sub_ksize = sp->mp_leaf2_ksize;
+ char *sub_key = page_leaf2key(sp, j, sub_ksize);
+ mdbx_assert(env, sub_key + sub_ksize <= end_of_subpage);
+ if (unlikely(end_of_subpage < sub_key + sub_ksize))
+ return MDBX_CORRUPTED;
+ } else {
+ mdbx_assert(env, IS_LEAF(sp));
+ if (unlikely(!IS_LEAF(sp)))
+ return MDBX_CORRUPTED;
+ const MDBX_node *const sub_node = page_node(sp, j);
+ const char *sub_node_end = (char *)sub_node + NODESIZE;
+ mdbx_assert(env, sub_node_end <= end_of_subpage);
+ if (unlikely(sub_node_end > end_of_subpage))
+ return MDBX_CORRUPTED;
+ mdbx_assert(env, node_flags(sub_node) == 0);
+ if (unlikely(node_flags(sub_node) != 0))
+ return MDBX_CORRUPTED;
+
+ size_t sub_ksize = node_ks(sub_node);
+ char *sub_key = node_key(sub_node);
+ size_t sub_dsize = node_ds(sub_node);
+ char *sub_data = node_data(sub_node);
+ mdbx_assert(env, sub_key + sub_ksize <= end_of_subpage);
+ if (unlikely(end_of_subpage < sub_key + sub_ksize))
+ return MDBX_CORRUPTED;
+ mdbx_assert(env, sub_data + sub_dsize <= end_of_subpage);
+ if (unlikely(end_of_subpage < sub_data + sub_dsize))
+ return MDBX_CORRUPTED;
+ }
+ }
+ }
+ break;
+ }
+ }
+ }
+ return MDBX_SUCCESS;
+}
+
+static __cold int mdbx_cursor_check(MDBX_cursor *mc, bool pending) {
+ mdbx_tassert(mc->mc_txn, mc->mc_txn->mt_parent ||
+ mc->mc_txn->tw.dirtyroom +
+ mc->mc_txn->tw.dirtylist->length ==
+ MDBX_DPL_TXNFULL);
+ mdbx_cassert(mc, mc->mc_top == mc->mc_snum - 1);
+ if (unlikely(mc->mc_top != mc->mc_snum - 1))
+ return MDBX_CURSOR_FULL;
+ mdbx_cassert(mc, pending ? mc->mc_snum <= mc->mc_db->md_depth
+ : mc->mc_snum == mc->mc_db->md_depth);
+ if (unlikely(pending ? mc->mc_snum > mc->mc_db->md_depth
+ : mc->mc_snum != mc->mc_db->md_depth))
+ return MDBX_CURSOR_FULL;
+
+ for (int n = 0; n < mc->mc_snum; ++n) {
+ MDBX_page *mp = mc->mc_pg[n];
+ const unsigned nkeys = page_numkeys(mp);
+ const bool expect_branch = (n < mc->mc_db->md_depth - 1) ? true : false;
+ const bool expect_nested_leaf =
+ (n + 1 == mc->mc_db->md_depth - 1) ? true : false;
+ const bool branch = IS_BRANCH(mp) ? true : false;
+ mdbx_cassert(mc, branch == expect_branch);
+ if (unlikely(branch != expect_branch))
+ return MDBX_CURSOR_FULL;
+ if (!pending) {
+ mdbx_cassert(mc,
+ nkeys > mc->mc_ki[n] || (!branch && nkeys == mc->mc_ki[n] &&
+ (mc->mc_flags & C_EOF) != 0));
+ if (unlikely(nkeys <= mc->mc_ki[n] &&
+ !(!branch && nkeys == mc->mc_ki[n] &&
+ (mc->mc_flags & C_EOF) != 0)))
+ return MDBX_CURSOR_FULL;
+ } else {
+ mdbx_cassert(mc, nkeys + 1 >= mc->mc_ki[n]);
+ if (unlikely(nkeys + 1 < mc->mc_ki[n]))
+ return MDBX_CURSOR_FULL;
+ }
+
+ int err = mdbx_page_check(mc->mc_txn->mt_env, mp, pending);
+ if (unlikely(err != MDBX_SUCCESS))
+ return err;
+
+ for (unsigned i = 0; i < nkeys; ++i) {
+ if (branch) {
+ MDBX_node *node = page_node(mp, i);
+ mdbx_cassert(mc, node_flags(node) == 0);
+ if (unlikely(node_flags(node) != 0))
+ return MDBX_CURSOR_FULL;
+ pgno_t pgno = node_pgno(node);
+ MDBX_page *np;
+ int rc = mdbx_page_get(mc, pgno, &np, NULL);
+ mdbx_cassert(mc, rc == MDBX_SUCCESS);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+ const bool nested_leaf = IS_LEAF(np) ? true : false;
+ mdbx_cassert(mc, nested_leaf == expect_nested_leaf);
+ if (unlikely(nested_leaf != expect_nested_leaf))
+ return MDBX_CURSOR_FULL;
+ err = mdbx_page_check(mc->mc_txn->mt_env, np, pending);
+ if (unlikely(err != MDBX_SUCCESS))
+ return err;
+ }
+ }
+ }
+ return MDBX_SUCCESS;
+}
+
+/* Complete a delete operation started by mdbx_cursor_del(). */
+static int mdbx_cursor_del0(MDBX_cursor *mc) {
+ int rc;
+ MDBX_page *mp;
+ indx_t ki;
+ unsigned nkeys;
+ MDBX_cursor *m2, *m3;
+ MDBX_dbi dbi = mc->mc_dbi;
+
+ mdbx_cassert(mc, IS_LEAF(mc->mc_pg[mc->mc_top]));
+ ki = mc->mc_ki[mc->mc_top];
+ mp = mc->mc_pg[mc->mc_top];
+ mdbx_node_del(mc, mc->mc_db->md_xsize);
+ mc->mc_db->md_entries--;
+ {
+ /* Adjust other cursors pointing to mp */
+ for (m2 = mc->mc_txn->mt_cursors[dbi]; m2; m2 = m2->mc_next) {
+ m3 = (mc->mc_flags & C_SUB) ? &m2->mc_xcursor->mx_cursor : m2;
+ if (m3 == mc || !(m2->mc_flags & m3->mc_flags & C_INITIALIZED))
+ continue;
+ if (m3->mc_snum < mc->mc_snum)
+ continue;
+ if (m3->mc_pg[mc->mc_top] == mp) {
+ if (m3->mc_ki[mc->mc_top] == ki) {
+ m3->mc_flags |= C_DEL;
+ if (mc->mc_db->md_flags & MDBX_DUPSORT) {
+ /* Sub-cursor referred into dataset which is gone */
+ m3->mc_xcursor->mx_cursor.mc_flags &= ~(C_INITIALIZED | C_EOF);
+ }
+ continue;
+ } else if (m3->mc_ki[mc->mc_top] > ki) {
+ m3->mc_ki[mc->mc_top]--;
+ }
+ if (XCURSOR_INITED(m3))
+ XCURSOR_REFRESH(m3, m3->mc_pg[mc->mc_top], m3->mc_ki[mc->mc_top]);
+ }
+ }
+ }
+ rc = mdbx_rebalance(mc);
+
+ if (likely(rc == MDBX_SUCCESS)) {
+ /* DB is totally empty now, just bail out.
+ * Other cursors adjustments were already done
+ * by mdbx_rebalance and aren't needed here. */
+ if (!mc->mc_snum) {
+ mdbx_cassert(mc, mc->mc_db->md_entries == 0 && mc->mc_db->md_depth == 0 &&
+ mc->mc_db->md_root == P_INVALID);
+ mc->mc_flags |= C_DEL | C_EOF;
+ return rc;
+ }
+
+ ki = mc->mc_ki[mc->mc_top];
+ mp = mc->mc_pg[mc->mc_top];
+ mdbx_cassert(mc, IS_LEAF(mc->mc_pg[mc->mc_top]));
+ nkeys = page_numkeys(mp);
+ mdbx_cassert(mc, (mc->mc_db->md_entries > 0 && nkeys > 0) ||
+ ((mc->mc_flags & C_SUB) &&
+ mc->mc_db->md_entries == 0 && nkeys == 0));
+
+ /* Adjust THIS and other cursors pointing to mp */
+ for (m2 = mc->mc_txn->mt_cursors[dbi]; m2; m2 = m2->mc_next) {
+ m3 = (mc->mc_flags & C_SUB) ? &m2->mc_xcursor->mx_cursor : m2;
+ if (m3 == mc || !(m2->mc_flags & m3->mc_flags & C_INITIALIZED))
+ continue;
+ if (m3->mc_snum < mc->mc_snum)
+ continue;
+ if (m3->mc_pg[mc->mc_top] == mp) {
+ /* if m3 points past last node in page, find next sibling */
+ if (m3->mc_ki[mc->mc_top] >= nkeys) {
+ rc = mdbx_cursor_sibling(m3, true);
+ if (rc == MDBX_NOTFOUND) {
+ m3->mc_flags |= C_EOF;
+ rc = MDBX_SUCCESS;
+ continue;
+ } else if (unlikely(rc != MDBX_SUCCESS))
+ break;
+ }
+ if (m3->mc_ki[mc->mc_top] >= ki || m3->mc_pg[mc->mc_top] != mp) {
+ if ((mc->mc_db->md_flags & MDBX_DUPSORT) != 0 &&
+ (m3->mc_flags & C_EOF) == 0) {
+ MDBX_node *node =
+ page_node(m3->mc_pg[m3->mc_top], m3->mc_ki[m3->mc_top]);
+ /* If this node has dupdata, it may need to be reinited
+ * because its data has moved.
+ * If the xcursor was not initd it must be reinited.
+ * Else if node points to a subDB, nothing is needed. */
+ if (node_flags(node) & F_DUPDATA) {
+ if (m3->mc_xcursor->mx_cursor.mc_flags & C_INITIALIZED) {
+ if (!(node_flags(node) & F_SUBDATA))
+ m3->mc_xcursor->mx_cursor.mc_pg[0] = node_data(node);
+ } else {
+ rc = mdbx_xcursor_init1(m3, node);
+ if (unlikely(rc != MDBX_SUCCESS))
+ break;
+ m3->mc_xcursor->mx_cursor.mc_flags |= C_DEL;
+ }
+ }
+ }
+ }
+ }
+ }
+
+ if (mc->mc_ki[mc->mc_top] >= nkeys) {
+ rc = mdbx_cursor_sibling(mc, true);
+ if (rc == MDBX_NOTFOUND) {
+ mc->mc_flags |= C_EOF;
+ rc = MDBX_SUCCESS;
+ }
+ }
+ if ((mc->mc_db->md_flags & MDBX_DUPSORT) != 0 &&
+ (mc->mc_flags & C_EOF) == 0) {
+ MDBX_node *node = page_node(mc->mc_pg[mc->mc_top], mc->mc_ki[mc->mc_top]);
+ /* If this node has dupdata, it may need to be reinited
+ * because its data has moved.
+ * If the xcursor was not initd it must be reinited.
+ * Else if node points to a subDB, nothing is needed. */
+ if (node_flags(node) & F_DUPDATA) {
+ if (mc->mc_xcursor->mx_cursor.mc_flags & C_INITIALIZED) {
+ if (!(node_flags(node) & F_SUBDATA))
+ mc->mc_xcursor->mx_cursor.mc_pg[0] = node_data(node);
+ } else {
+ rc = mdbx_xcursor_init1(mc, node);
+ if (likely(rc != MDBX_SUCCESS))
+ mc->mc_xcursor->mx_cursor.mc_flags |= C_DEL;
+ }
+ }
+ }
+ mc->mc_flags |= C_DEL;
+ }
+
+ if (unlikely(rc))
+ mc->mc_txn->mt_flags |= MDBX_TXN_ERROR;
+ else if (mdbx_audit_enabled())
+ rc = mdbx_cursor_check(mc, false);
+
+ return rc;
+}
+
+int mdbx_del(MDBX_txn *txn, MDBX_dbi dbi, MDBX_val *key, MDBX_val *data) {
+ int rc = check_txn_rw(txn, MDBX_TXN_BLOCKED);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ if (unlikely(!key))
+ return MDBX_EINVAL;
+
+ if (unlikely(!TXN_DBI_EXIST(txn, dbi, DB_USRVALID)))
+ return MDBX_EINVAL;
+
+ if (unlikely(txn->mt_flags & (MDBX_RDONLY | MDBX_TXN_BLOCKED)))
+ return (txn->mt_flags & MDBX_RDONLY) ? MDBX_EACCESS : MDBX_BAD_TXN;
+
+ return mdbx_del0(txn, dbi, key, data, 0);
+}
+
+static int mdbx_del0(MDBX_txn *txn, MDBX_dbi dbi, MDBX_val *key, MDBX_val *data,
+ unsigned flags) {
+ MDBX_cursor_couple cx;
+ MDBX_cursor_op op;
+ MDBX_val rdata;
+ int rc, exact = 0;
+ DKBUF;
+
+ mdbx_debug("====> delete db %u key [%s], data [%s]", dbi, DKEY(key),
+ DVAL(data));
+
+ rc = mdbx_cursor_init(&cx.outer, txn, dbi);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ if (data) {
+ op = MDBX_GET_BOTH;
+ rdata = *data;
+ data = &rdata;
+ } else {
+ op = MDBX_SET;
+ flags |= MDBX_NODUPDATA;
+ }
+ rc = mdbx_cursor_set(&cx.outer, key, data, op, &exact);
+ if (likely(rc == MDBX_SUCCESS)) {
+ /* let mdbx_page_split know about this cursor if needed:
+ * delete will trigger a rebalance; if it needs to move
+ * a node from one page to another, it will have to
+ * update the parent's separator key(s). If the new sepkey
+ * is larger than the current one, the parent page may
+ * run out of space, triggering a split. We need this
+ * cursor to be consistent until the end of the rebalance. */
+ cx.outer.mc_next = txn->mt_cursors[dbi];
+ txn->mt_cursors[dbi] = &cx.outer;
+ rc = mdbx_cursor_del(&cx.outer, flags);
+ txn->mt_cursors[dbi] = cx.outer.mc_next;
+ }
+ return rc;
+}
+
+/* Split a page and insert a new node.
+ * Set MDBX_TXN_ERROR on failure.
+ * [in,out] mc Cursor pointing to the page and desired insertion index.
+ * The cursor will be updated to point to the actual page and index where
+ * the node got inserted after the split.
+ * [in] newkey The key for the newly inserted node.
+ * [in] newdata The data for the newly inserted node.
+ * [in] newpgno The page number, if the new node is a branch node.
+ * [in] nflags The NODE_ADD_FLAGS for the new node.
+ * Returns 0 on success, non-zero on failure. */
+static int mdbx_page_split(MDBX_cursor *mc, const MDBX_val *newkey,
+ MDBX_val *newdata, pgno_t newpgno, unsigned nflags) {
+ unsigned flags;
+ int rc = MDBX_SUCCESS, foliage = 0, did_split = 0;
+ pgno_t pgno = 0;
+ unsigned i, ptop;
+ MDBX_env *env = mc->mc_txn->mt_env;
+ MDBX_node *node;
+ MDBX_val sepkey, rkey, xdata;
+ MDBX_page *copy = NULL;
+ MDBX_page *rp, *pp;
+ MDBX_cursor mn;
+ DKBUF;
+
+ MDBX_page *mp = mc->mc_pg[mc->mc_top];
+ unsigned newindx = mc->mc_ki[mc->mc_top];
+ unsigned nkeys = page_numkeys(mp);
+ if (mdbx_audit_enabled()) {
+ rc = mdbx_cursor_check(mc, true);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+ }
+
+ mdbx_debug("-----> splitting %s page %" PRIaPGNO
+ " and adding [%s] at index %i/%i",
+ IS_LEAF(mp) ? "leaf" : "branch", mp->mp_pgno, DKEY(newkey),
+ mc->mc_ki[mc->mc_top], nkeys);
+
+ /* Create a right sibling. */
+ if ((rc = mdbx_page_new(mc, mp->mp_flags, 1, &rp)))
+ return rc;
+ rp->mp_leaf2_ksize = mp->mp_leaf2_ksize;
+ mdbx_debug("new right sibling: page %" PRIaPGNO, rp->mp_pgno);
+
+ /* Usually when splitting the root page, the cursor
+ * height is 1. But when called from mdbx_update_key,
+ * the cursor height may be greater because it walks
+ * up the stack while finding the branch slot to update. */
+ if (mc->mc_top < 1) {
+ if ((rc = mdbx_page_new(mc, P_BRANCH, 1, &pp)))
+ goto done;
+ /* shift current top to make room for new parent */
+ mdbx_cassert(mc, mc->mc_snum < 2 && mc->mc_db->md_depth > 0);
+ mc->mc_pg[2] = mc->mc_pg[1];
+ mc->mc_ki[2] = mc->mc_ki[1];
+ mc->mc_pg[1] = mc->mc_pg[0];
+ mc->mc_ki[1] = mc->mc_ki[0];
+ mc->mc_pg[0] = pp;
+ mc->mc_ki[0] = 0;
+ mc->mc_db->md_root = pp->mp_pgno;
+ mdbx_debug("root split! new root = %" PRIaPGNO, pp->mp_pgno);
+ foliage = mc->mc_db->md_depth++;
+
+ /* Add left (implicit) pointer. */
+ if (unlikely((rc = mdbx_node_add_branch(mc, 0, NULL, mp->mp_pgno)) !=
+ MDBX_SUCCESS)) {
+ /* undo the pre-push */
+ mc->mc_pg[0] = mc->mc_pg[1];
+ mc->mc_ki[0] = mc->mc_ki[1];
+ mc->mc_db->md_root = mp->mp_pgno;
+ mc->mc_db->md_depth--;
+ goto done;
+ }
+ mc->mc_snum++;
+ mc->mc_top++;
+ ptop = 0;
+ } else {
+ ptop = mc->mc_top - 1;
+ mdbx_debug("parent branch page is %" PRIaPGNO, mc->mc_pg[ptop]->mp_pgno);
+ }
+
+ mdbx_cursor_copy(mc, &mn);
+ mn.mc_xcursor = NULL;
+ mn.mc_pg[mn.mc_top] = rp;
+ mn.mc_ki[mn.mc_top] = 0;
+ mn.mc_ki[ptop] = mc->mc_ki[ptop] + 1;
+
+ unsigned split_indx;
+ if (nflags & MDBX_APPEND) {
+ mn.mc_ki[mn.mc_top] = 0;
+ sepkey = *newkey;
+ split_indx = newindx;
+ nkeys = 0;
+ } else {
+ split_indx = (nkeys + 1) / 2;
+ if (IS_LEAF2(rp)) {
+ char *split, *ins;
+ int x;
+ unsigned lsize, rsize, ksize;
+ /* Move half of the keys to the right sibling */
+ x = mc->mc_ki[mc->mc_top] - split_indx;
+ ksize = mc->mc_db->md_xsize;
+ split = page_leaf2key(mp, split_indx, ksize);
+ rsize = (nkeys - split_indx) * ksize;
+ lsize = (nkeys - split_indx) * sizeof(indx_t);
+ mdbx_cassert(mc, mp->mp_lower >= lsize);
+ mp->mp_lower -= (indx_t)lsize;
+ mdbx_cassert(mc, rp->mp_lower + lsize <= UINT16_MAX);
+ rp->mp_lower += (indx_t)lsize;
+ mdbx_cassert(mc, mp->mp_upper + rsize - lsize <= UINT16_MAX);
+ mp->mp_upper += (indx_t)(rsize - lsize);
+ mdbx_cassert(mc, rp->mp_upper >= rsize - lsize);
+ rp->mp_upper -= (indx_t)(rsize - lsize);
+ sepkey.iov_len = ksize;
+ if (newindx == split_indx) {
+ sepkey.iov_base = newkey->iov_base;
+ } else {
+ sepkey.iov_base = split;
+ }
+ if (x < 0) {
+ mdbx_cassert(mc, ksize >= sizeof(indx_t));
+ ins = page_leaf2key(mp, mc->mc_ki[mc->mc_top], ksize);
+ memcpy(rp->mp_ptrs, split, rsize);
+ sepkey.iov_base = rp->mp_ptrs;
+ memmove(ins + ksize, ins, (split_indx - mc->mc_ki[mc->mc_top]) * ksize);
+ memcpy(ins, newkey->iov_base, ksize);
+ mdbx_cassert(mc, UINT16_MAX - mp->mp_lower >= (int)sizeof(indx_t));
+ mp->mp_lower += sizeof(indx_t);
+ mdbx_cassert(mc, mp->mp_upper >= ksize - sizeof(indx_t));
+ mp->mp_upper -= (indx_t)(ksize - sizeof(indx_t));
+ } else {
+ if (x)
+ memcpy(rp->mp_ptrs, split, x * ksize);
+ ins = page_leaf2key(rp, x, ksize);
+ memcpy(ins, newkey->iov_base, ksize);
+ memcpy(ins + ksize, split + x * ksize, rsize - x * ksize);
+ mdbx_cassert(mc, UINT16_MAX - rp->mp_lower >= (int)sizeof(indx_t));
+ rp->mp_lower += sizeof(indx_t);
+ mdbx_cassert(mc, rp->mp_upper >= ksize - sizeof(indx_t));
+ rp->mp_upper -= (indx_t)(ksize - sizeof(indx_t));
+ mdbx_cassert(mc, x <= UINT16_MAX);
+ mc->mc_ki[mc->mc_top] = (indx_t)x;
+ }
+ } else {
+ size_t psize, nsize, k;
+ /* Maximum free space in an empty page */
+ const unsigned pmax = page_space(env);
+ nsize = IS_LEAF(mp) ? leaf_size(env, newkey, newdata)
+ : branch_size(env, newkey);
+
+ /* grab a page to hold a temporary copy */
+ copy = mdbx_page_malloc(mc->mc_txn, 1);
+ if (unlikely(copy == NULL)) {
+ rc = MDBX_ENOMEM;
+ goto done;
+ }
+ copy->mp_pgno = mp->mp_pgno;
+ copy->mp_flags = mp->mp_flags;
+ copy->mp_lower = 0;
+ copy->mp_upper = (indx_t)page_space(env);
+
+ /* prepare to insert */
+ for (unsigned j = i = 0; i < nkeys; i++) {
+ if (i == newindx)
+ copy->mp_ptrs[j++] = 0;
+ copy->mp_ptrs[j++] = mp->mp_ptrs[i];
+ }
+
+ /* When items are relatively large the split point needs
+ * to be checked, because being off-by-one will make the
+ * difference between success or failure in mdbx_node_add.
+ *
+ * It's also relevant if a page happens to be laid out
+ * such that one half of its nodes are all "small" and
+ * the other half of its nodes are "large." If the new
+ * item is also "large" and falls on the half with
+ * "large" nodes, it also may not fit.
+ *
+ * As a final tweak, if the new item goes on the last
+ * spot on the page (and thus, onto the new page), bias
+ * the split so the new page is emptier than the old page.
+ * This yields better packing during sequential inserts.
+ */
+ int dir;
+ if (nkeys < 32 || nsize > pmax / 16 || newindx >= nkeys) {
+ /* Find split point */
+ psize = 0;
+ if (newindx <= split_indx || newindx >= nkeys) {
+ i = 0;
+ dir = 1;
+ k = (newindx >= nkeys) ? nkeys : split_indx + 1 + IS_LEAF(mp);
+ } else {
+ i = nkeys;
+ dir = -1;
+ k = split_indx - 1;
+ }
+ for (; i != k; i += dir) {
+ if (i == newindx) {
+ psize += nsize;
+ node = NULL;
+ } else {
+ node = (MDBX_node *)((char *)mp + copy->mp_ptrs[i] + PAGEHDRSZ);
+ psize += NODESIZE + node_ks(node) + sizeof(indx_t);
+ if (IS_LEAF(mp)) {
+ if (F_ISSET(node_flags(node), F_BIGDATA))
+ psize += sizeof(pgno_t);
+ else
+ psize += node_ds(node);
+ }
+ psize = EVEN(psize);
+ }
+ if (psize > pmax || i == k - dir) {
+ split_indx = i + (dir < 0);
+ break;
+ }
+ }
+ }
+ if (split_indx == newindx) {
+ sepkey.iov_len = newkey->iov_len;
+ sepkey.iov_base = newkey->iov_base;
+ } else {
+ node =
+ (MDBX_node *)((char *)mp + copy->mp_ptrs[split_indx] + PAGEHDRSZ);
+ sepkey.iov_len = node_ks(node);
+ sepkey.iov_base = node_key(node);
+ }
+ }
+ }
+
+ mdbx_debug("separator is %d [%s]", split_indx, DKEY(&sepkey));
+ if (mdbx_audit_enabled()) {
+ rc = mdbx_cursor_check(mc, true);
+ if (unlikely(rc != MDBX_SUCCESS))
+ goto done;
+ rc = mdbx_cursor_check(&mn, true);
+ if (unlikely(rc != MDBX_SUCCESS))
+ goto done;
+ }
+
+ /* Copy separator key to the parent. */
+ if (page_room(mn.mc_pg[ptop]) < branch_size(env, &sepkey)) {
+ const int snum = mc->mc_snum;
+ const int depth = mc->mc_db->md_depth;
+ mn.mc_snum--;
+ mn.mc_top--;
+ did_split = 1;
+ /* We want other splits to find mn when doing fixups */
+ WITH_CURSOR_TRACKING(
+ mn, rc = mdbx_page_split(&mn, &sepkey, NULL, rp->mp_pgno, 0));
+ if (unlikely(rc != MDBX_SUCCESS))
+ goto done;
+ mdbx_cassert(mc, mc->mc_snum - snum == mc->mc_db->md_depth - depth);
+ if (mdbx_audit_enabled()) {
+ rc = mdbx_cursor_check(mc, true);
+ if (unlikely(rc != MDBX_SUCCESS))
+ goto done;
+ }
+
+ /* root split? */
+ ptop += mc->mc_snum - snum;
+
+ /* Right page might now have changed parent.
+ * Check if left page also changed parent. */
+ if (mn.mc_pg[ptop] != mc->mc_pg[ptop] &&
+ mc->mc_ki[ptop] >= page_numkeys(mc->mc_pg[ptop])) {
+ for (i = 0; i < ptop; i++) {
+ mc->mc_pg[i] = mn.mc_pg[i];
+ mc->mc_ki[i] = mn.mc_ki[i];
+ }
+ mc->mc_pg[ptop] = mn.mc_pg[ptop];
+ if (mn.mc_ki[ptop]) {
+ mc->mc_ki[ptop] = mn.mc_ki[ptop] - 1;
+ } else {
+ /* find right page's left sibling */
+ mc->mc_ki[ptop] = mn.mc_ki[ptop];
+ rc = mdbx_cursor_sibling(mc, false);
+ }
+ }
+ } else {
+ mn.mc_top--;
+ rc = mdbx_node_add_branch(&mn, mn.mc_ki[ptop], &sepkey, rp->mp_pgno);
+ mn.mc_top++;
+ }
+ if (unlikely(rc != MDBX_SUCCESS)) {
+ if (rc == MDBX_NOTFOUND) /* improper mdbx_cursor_sibling() result */ {
+ mdbx_error("unexpected %s", "MDBX_NOTFOUND");
+ rc = MDBX_PROBLEM;
+ }
+ goto done;
+ }
+
+ if (nflags & MDBX_APPEND) {
+ mc->mc_pg[mc->mc_top] = rp;
+ mc->mc_ki[mc->mc_top] = 0;
+ switch (PAGETYPE(rp)) {
+ case P_BRANCH: {
+ mdbx_cassert(mc, (nflags & (F_BIGDATA | F_SUBDATA | F_DUPDATA)) == 0);
+ mdbx_cassert(mc, newpgno != 0 && newpgno != P_INVALID);
+ rc = mdbx_node_add_branch(mc, 0, newkey, newpgno);
+ } break;
+ case P_LEAF: {
+ mdbx_cassert(mc, newpgno == 0 || newpgno == P_INVALID);
+ rc = mdbx_node_add_leaf(mc, 0, newkey, newdata, nflags);
+ } break;
+ case P_LEAF | P_LEAF2: {
+ mdbx_cassert(mc, (nflags & (F_BIGDATA | F_SUBDATA | F_DUPDATA)) == 0);
+ mdbx_cassert(mc, newpgno == 0 || newpgno == P_INVALID);
+ rc = mdbx_node_add_leaf2(mc, 0, newkey);
+ } break;
+ default:
+ rc = MDBX_CORRUPTED;
+ }
+ if (rc)
+ goto done;
+ for (i = 0; i < mc->mc_top; i++)
+ mc->mc_ki[i] = mn.mc_ki[i];
+ } else if (!IS_LEAF2(mp)) {
+ /* Move nodes */
+ mc->mc_pg[mc->mc_top] = rp;
+ i = split_indx;
+ indx_t n = 0;
+ do {
+ MDBX_val *rdata = NULL;
+ if (i == newindx) {
+ rkey.iov_base = newkey->iov_base;
+ rkey.iov_len = newkey->iov_len;
+ if (IS_LEAF(mp)) {
+ rdata = newdata;
+ } else
+ pgno = newpgno;
+ flags = nflags;
+ /* Update index for the new key. */
+ mc->mc_ki[mc->mc_top] = n;
+ } else {
+ node = (MDBX_node *)((char *)mp + copy->mp_ptrs[i] + PAGEHDRSZ);
+ rkey.iov_base = node_key(node);
+ rkey.iov_len = node_ks(node);
+ if (IS_LEAF(mp)) {
+ xdata.iov_base = node_data(node);
+ xdata.iov_len = node_ds(node);
+ rdata = &xdata;
+ } else
+ pgno = node_pgno(node);
+ flags = node_flags(node);
+ }
+
+ switch (PAGETYPE(rp)) {
+ case P_BRANCH: {
+ mdbx_cassert(mc, 0 == (uint16_t)flags);
+ if (n == 0) {
+ /* First branch index doesn't need key data. */
+ rkey.iov_len = 0;
+ }
+ rc = mdbx_node_add_branch(mc, n, &rkey, pgno);
+ } break;
+ case P_LEAF: {
+ mdbx_cassert(mc, pgno == 0);
+ mdbx_cassert(mc, rdata != NULL);
+ rc = mdbx_node_add_leaf(mc, n, &rkey, rdata, flags);
+ } break;
+ /* case P_LEAF | P_LEAF2: {
+ mdbx_cassert(mc, (nflags & (F_BIGDATA | F_SUBDATA | F_DUPDATA)) == 0);
+ mdbx_cassert(mc, gno == 0);
+ rc = mdbx_node_add_leaf2(mc, n, &rkey);
+ } break; */
+ default:
+ rc = MDBX_CORRUPTED;
+ }
+ if (rc)
+ goto done;
+
+ if (i == nkeys) {
+ i = 0;
+ n = 0;
+ mc->mc_pg[mc->mc_top] = copy;
+ } else {
+ i++;
+ n++;
+ }
+ } while (i != split_indx);
+
+ nkeys = page_numkeys(copy);
+ for (i = 0; i < nkeys; i++)
+ mp->mp_ptrs[i] = copy->mp_ptrs[i];
+ mp->mp_lower = copy->mp_lower;
+ mp->mp_upper = copy->mp_upper;
+ memcpy(page_node(mp, nkeys - 1), page_node(copy, nkeys - 1),
+ env->me_psize - copy->mp_upper - PAGEHDRSZ);
+
+ /* reset back to original page */
+ if (newindx < split_indx) {
+ mc->mc_pg[mc->mc_top] = mp;
+ } else {
+ mc->mc_pg[mc->mc_top] = rp;
+ mc->mc_ki[ptop]++;
+ /* Make sure mc_ki is still valid. */
+ if (mn.mc_pg[ptop] != mc->mc_pg[ptop] &&
+ mc->mc_ki[ptop] >= page_numkeys(mc->mc_pg[ptop])) {
+ for (i = 0; i <= ptop; i++) {
+ mc->mc_pg[i] = mn.mc_pg[i];
+ mc->mc_ki[i] = mn.mc_ki[i];
+ }
+ }
+ }
+ if (nflags & MDBX_RESERVE) {
+ node = page_node(mc->mc_pg[mc->mc_top], mc->mc_ki[mc->mc_top]);
+ if (!(node_flags(node) & F_BIGDATA))
+ newdata->iov_base = node_data(node);
+ }
+ } else {
+ if (newindx >= split_indx) {
+ mc->mc_pg[mc->mc_top] = rp;
+ mc->mc_ki[ptop]++;
+ /* Make sure mc_ki is still valid. */
+ if (mn.mc_pg[ptop] != mc->mc_pg[ptop] &&
+ mc->mc_ki[ptop] >= page_numkeys(mc->mc_pg[ptop])) {
+ for (i = 0; i <= ptop; i++) {
+ mc->mc_pg[i] = mn.mc_pg[i];
+ mc->mc_ki[i] = mn.mc_ki[i];
+ }
+ }
+ }
+ }
+
+ {
+ /* Adjust other cursors pointing to mp */
+ MDBX_cursor *m2, *m3;
+ MDBX_dbi dbi = mc->mc_dbi;
+ nkeys = page_numkeys(mp);
+
+ for (m2 = mc->mc_txn->mt_cursors[dbi]; m2; m2 = m2->mc_next) {
+ m3 = (mc->mc_flags & C_SUB) ? &m2->mc_xcursor->mx_cursor : m2;
+ if (m3 == mc)
+ continue;
+ if (!(m2->mc_flags & m3->mc_flags & C_INITIALIZED))
+ continue;
+ if (foliage) {
+ int k;
+ /* sub cursors may be on different DB */
+ if (m3->mc_pg[0] != mp)
+ continue;
+ /* root split */
+ for (k = foliage; k >= 0; k--) {
+ m3->mc_ki[k + 1] = m3->mc_ki[k];
+ m3->mc_pg[k + 1] = m3->mc_pg[k];
+ }
+ m3->mc_ki[0] = (m3->mc_ki[0] >= nkeys) ? 1 : 0;
+ m3->mc_pg[0] = mc->mc_pg[0];
+ m3->mc_snum++;
+ m3->mc_top++;
+ }
+ if (m3->mc_top >= mc->mc_top && m3->mc_pg[mc->mc_top] == mp) {
+ if (m3->mc_ki[mc->mc_top] >= newindx && !(nflags & MDBX_SPLIT_REPLACE))
+ m3->mc_ki[mc->mc_top]++;
+ if (m3->mc_ki[mc->mc_top] >= nkeys) {
+ m3->mc_pg[mc->mc_top] = rp;
+ mdbx_cassert(mc, m3->mc_ki[mc->mc_top] >= nkeys);
+ m3->mc_ki[mc->mc_top] -= (indx_t)nkeys;
+ for (i = 0; i < mc->mc_top; i++) {
+ m3->mc_ki[i] = mn.mc_ki[i];
+ m3->mc_pg[i] = mn.mc_pg[i];
+ }
+ }
+ } else if (!did_split && m3->mc_top >= ptop &&
+ m3->mc_pg[ptop] == mc->mc_pg[ptop] &&
+ m3->mc_ki[ptop] >= mc->mc_ki[ptop]) {
+ m3->mc_ki[ptop]++;
+ }
+ if (XCURSOR_INITED(m3) && IS_LEAF(mp))
+ XCURSOR_REFRESH(m3, m3->mc_pg[mc->mc_top], m3->mc_ki[mc->mc_top]);
+ }
+ }
+ mdbx_debug("mp left: %d, rp left: %d", page_room(mp), page_room(rp));
+
+done:
+ if (copy) /* tmp page */
+ mdbx_dpage_free(env, copy, 1);
+ if (unlikely(rc))
+ mc->mc_txn->mt_flags |= MDBX_TXN_ERROR;
+ return rc;
+}
+
+int mdbx_put(MDBX_txn *txn, MDBX_dbi dbi, MDBX_val *key, MDBX_val *data,
+ unsigned flags) {
+ int rc = check_txn_rw(txn, MDBX_TXN_BLOCKED);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ if (unlikely(!key || !data))
+ return MDBX_EINVAL;
+
+ if (unlikely(!TXN_DBI_EXIST(txn, dbi, DB_USRVALID)))
+ return MDBX_EINVAL;
+
+ if (unlikely(flags & ~(MDBX_NOOVERWRITE | MDBX_NODUPDATA | MDBX_RESERVE |
+ MDBX_APPEND | MDBX_APPENDDUP | MDBX_CURRENT)))
+ return MDBX_EINVAL;
+
+ if (unlikely(txn->mt_flags & (MDBX_RDONLY | MDBX_TXN_BLOCKED)))
+ return (txn->mt_flags & MDBX_RDONLY) ? MDBX_EACCESS : MDBX_BAD_TXN;
+
+ MDBX_cursor_couple cx;
+ rc = mdbx_cursor_init(&cx.outer, txn, dbi);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+ cx.outer.mc_next = txn->mt_cursors[dbi];
+ txn->mt_cursors[dbi] = &cx.outer;
+
+ /* LY: support for update (explicit overwrite) */
+ if (flags & MDBX_CURRENT) {
+ rc = mdbx_cursor_get(&cx.outer, key, NULL, MDBX_SET);
+ if (likely(rc == MDBX_SUCCESS) &&
+ (txn->mt_dbs[dbi].md_flags & MDBX_DUPSORT)) {
+ /* LY: allows update (explicit overwrite) only for unique keys */
+ MDBX_node *node = page_node(cx.outer.mc_pg[cx.outer.mc_top],
+ cx.outer.mc_ki[cx.outer.mc_top]);
+ if (F_ISSET(node_flags(node), F_DUPDATA)) {
+ mdbx_tassert(txn, XCURSOR_INITED(&cx.outer) &&
+ cx.outer.mc_xcursor->mx_db.md_entries > 1);
+ rc = MDBX_EMULTIVAL;
+ }
+ }
+ }
+
+ if (likely(rc == MDBX_SUCCESS))
+ rc = mdbx_cursor_put(&cx.outer, key, data, flags);
+ txn->mt_cursors[dbi] = cx.outer.mc_next;
+
+ return rc;
+}
+
+/**** COPYING *****************************************************************/
+
+#ifndef MDBX_WBUF
+#define MDBX_WBUF ((size_t)1024 * 1024)
+#endif
+#define MDBX_EOF 0x10 /* mdbx_env_copyfd1() is done reading */
+
+/* State needed for a double-buffering compacting copy. */
+typedef struct mdbx_copy {
+ MDBX_env *mc_env;
+ MDBX_txn *mc_txn;
+ mdbx_condmutex_t mc_condmutex;
+ uint8_t *mc_wbuf[2];
+ uint8_t *mc_over[2];
+ size_t mc_wlen[2];
+ size_t mc_olen[2];
+ mdbx_filehandle_t mc_fd;
+ volatile int mc_error;
+ pgno_t mc_next_pgno;
+ short mc_toggle; /* Buffer number in provider */
+ short mc_new; /* (0-2 buffers to write) | (MDBX_EOF at end) */
+ /* Error code. Never cleared if set. Both threads can set nonzero
+ * to fail the copy. Not mutex-protected, MDBX expects atomic int. */
+} mdbx_copy;
+
+/* Dedicated writer thread for compacting copy. */
+static THREAD_RESULT __cold THREAD_CALL mdbx_env_copythr(void *arg) {
+ mdbx_copy *my = arg;
+ uint8_t *ptr;
+ int toggle = 0;
+ int rc;
+
+ mdbx_condmutex_lock(&my->mc_condmutex);
+ while (!my->mc_error) {
+ while (!my->mc_new)
+ mdbx_condmutex_wait(&my->mc_condmutex);
+ if (my->mc_new == 0 + MDBX_EOF) /* 0 buffers, just EOF */
+ break;
+ size_t wsize = my->mc_wlen[toggle];
+ ptr = my->mc_wbuf[toggle];
+ again:
+ if (wsize > 0 && !my->mc_error) {
+ rc = mdbx_write(my->mc_fd, ptr, wsize);
+ if (rc != MDBX_SUCCESS) {
+ my->mc_error = rc;
+ break;
+ }
+ }
+
+ /* If there's an overflow page tail, write it too */
+ if (my->mc_olen[toggle]) {
+ wsize = my->mc_olen[toggle];
+ ptr = my->mc_over[toggle];
+ my->mc_olen[toggle] = 0;
+ goto again;
+ }
+ my->mc_wlen[toggle] = 0;
+ toggle ^= 1;
+ /* Return the empty buffer to provider */
+ my->mc_new--;
+ mdbx_condmutex_signal(&my->mc_condmutex);
+ }
+ mdbx_condmutex_unlock(&my->mc_condmutex);
+ return (THREAD_RESULT)0;
+}
+
+/* Give buffer and/or MDBX_EOF to writer thread, await unused buffer.
+ *
+ * [in] my control structure.
+ * [in] adjust (1 to hand off 1 buffer) | (MDBX_EOF when ending). */
+static int __cold mdbx_env_cthr_toggle(mdbx_copy *my, int adjust) {
+ mdbx_condmutex_lock(&my->mc_condmutex);
+ my->mc_new += (short)adjust;
+ mdbx_condmutex_signal(&my->mc_condmutex);
+ while (my->mc_new & 2) /* both buffers in use */
+ mdbx_condmutex_wait(&my->mc_condmutex);
+ mdbx_condmutex_unlock(&my->mc_condmutex);
+
+ my->mc_toggle ^= (adjust & 1);
+ /* Both threads reset mc_wlen, to be safe from threading errors */
+ my->mc_wlen[my->mc_toggle] = 0;
+ return my->mc_error;
+}
+
+/* Depth-first tree traversal for compacting copy.
+ * [in] my control structure.
+ * [in,out] pg database root.
+ * [in] flags includes F_DUPDATA if it is a sorted-duplicate sub-DB. */
+static int __cold mdbx_env_cwalk(mdbx_copy *my, pgno_t *pg, int flags) {
+ MDBX_cursor mc;
+ MDBX_page *mo, *mp, *leaf;
+ char *buf, *ptr;
+ int rc, toggle;
+ unsigned i;
+
+ /* Empty DB, nothing to do */
+ if (*pg == P_INVALID)
+ return MDBX_SUCCESS;
+
+ memset(&mc, 0, sizeof(mc));
+ mc.mc_snum = 1;
+ mc.mc_txn = my->mc_txn;
+
+ rc = mdbx_page_get(&mc, *pg, &mc.mc_pg[0], NULL);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+ rc = mdbx_page_search_root(&mc, NULL, MDBX_PS_FIRST);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ /* Make cursor pages writable */
+ buf = ptr = mdbx_malloc(pgno2bytes(my->mc_env, mc.mc_snum));
+ if (buf == NULL)
+ return MDBX_ENOMEM;
+
+ for (i = 0; i < mc.mc_top; i++) {
+ mdbx_page_copy((MDBX_page *)ptr, mc.mc_pg[i], my->mc_env->me_psize);
+ mc.mc_pg[i] = (MDBX_page *)ptr;
+ ptr += my->mc_env->me_psize;
+ }
+
+ /* This is writable space for a leaf page. Usually not needed. */
+ leaf = (MDBX_page *)ptr;
+
+ toggle = my->mc_toggle;
+ while (mc.mc_snum > 0) {
+ unsigned n;
+ mp = mc.mc_pg[mc.mc_top];
+ n = page_numkeys(mp);
+
+ if (IS_LEAF(mp)) {
+ if (!IS_LEAF2(mp) && !(flags & F_DUPDATA)) {
+ for (i = 0; i < n; i++) {
+ MDBX_node *node = page_node(mp, i);
+ if (node_flags(node) & F_BIGDATA) {
+ MDBX_page *omp;
+
+ /* Need writable leaf */
+ if (mp != leaf) {
+ mc.mc_pg[mc.mc_top] = leaf;
+ mdbx_page_copy(leaf, mp, my->mc_env->me_psize);
+ mp = leaf;
+ node = page_node(mp, i);
+ }
+
+ const pgno_t pgno = node_largedata_pgno(node);
+ poke_pgno(node_data(node), my->mc_next_pgno);
+ rc = mdbx_page_get(&mc, pgno, &omp, NULL);
+ if (unlikely(rc != MDBX_SUCCESS))
+ goto done;
+ if (my->mc_wlen[toggle] >= MDBX_WBUF) {
+ rc = mdbx_env_cthr_toggle(my, 1);
+ if (unlikely(rc != MDBX_SUCCESS))
+ goto done;
+ toggle = my->mc_toggle;
+ }
+ mo = (MDBX_page *)(my->mc_wbuf[toggle] + my->mc_wlen[toggle]);
+ memcpy(mo, omp, my->mc_env->me_psize);
+ mo->mp_pgno = my->mc_next_pgno;
+ my->mc_next_pgno += omp->mp_pages;
+ my->mc_wlen[toggle] += my->mc_env->me_psize;
+ if (omp->mp_pages > 1) {
+ my->mc_olen[toggle] = pgno2bytes(my->mc_env, omp->mp_pages - 1);
+ my->mc_over[toggle] = (uint8_t *)omp + my->mc_env->me_psize;
+ rc = mdbx_env_cthr_toggle(my, 1);
+ if (unlikely(rc != MDBX_SUCCESS))
+ goto done;
+ toggle = my->mc_toggle;
+ }
+ } else if (node_flags(node) & F_SUBDATA) {
+ if (node_ds(node) < sizeof(MDBX_db)) {
+ rc = MDBX_CORRUPTED;
+ goto done;
+ }
+
+ /* Need writable leaf */
+ if (mp != leaf) {
+ mc.mc_pg[mc.mc_top] = leaf;
+ mdbx_page_copy(leaf, mp, my->mc_env->me_psize);
+ mp = leaf;
+ node = page_node(mp, i);
+ }
+
+ MDBX_db db;
+ memcpy(&db, node_data(node), sizeof(MDBX_db));
+ my->mc_toggle = (short)toggle;
+ rc = mdbx_env_cwalk(my, &db.md_root, node_flags(node) & F_DUPDATA);
+ if (rc)
+ goto done;
+ toggle = my->mc_toggle;
+ memcpy(node_data(node), &db, sizeof(MDBX_db));
+ }
+ }
+ }
+ } else {
+ mc.mc_ki[mc.mc_top]++;
+ if (mc.mc_ki[mc.mc_top] < n) {
+ again:
+ rc = mdbx_page_get(&mc, node_pgno(page_node(mp, mc.mc_ki[mc.mc_top])),
+ &mp, NULL);
+ if (unlikely(rc != MDBX_SUCCESS))
+ goto done;
+ mc.mc_top++;
+ mc.mc_snum++;
+ mc.mc_ki[mc.mc_top] = 0;
+ if (IS_BRANCH(mp)) {
+ /* Whenever we advance to a sibling branch page,
+ * we must proceed all the way down to its first leaf. */
+ mdbx_page_copy(mc.mc_pg[mc.mc_top], mp, my->mc_env->me_psize);
+ goto again;
+ } else
+ mc.mc_pg[mc.mc_top] = mp;
+ continue;
+ }
+ }
+ if (my->mc_wlen[toggle] >= MDBX_WBUF) {
+ rc = mdbx_env_cthr_toggle(my, 1);
+ if (unlikely(rc != MDBX_SUCCESS))
+ goto done;
+ toggle = my->mc_toggle;
+ }
+ mo = (MDBX_page *)(my->mc_wbuf[toggle] + my->mc_wlen[toggle]);
+ mdbx_page_copy(mo, mp, my->mc_env->me_psize);
+ mo->mp_pgno = my->mc_next_pgno++;
+ my->mc_wlen[toggle] += my->mc_env->me_psize;
+ if (mc.mc_top) {
+ /* Update parent if there is one */
+ node_set_pgno(page_node(mc.mc_pg[mc.mc_top - 1], mc.mc_ki[mc.mc_top - 1]),
+ mo->mp_pgno);
+ mdbx_cursor_pop(&mc);
+ } else {
+ /* Otherwise we're done */
+ *pg = mo->mp_pgno;
+ break;
+ }
+ }
+done:
+ mdbx_free(buf);
+ return rc;
+}
+
+static __cold void compact_fixup_meta(MDBX_env *env, MDBX_meta *meta) {
+ /* Calculate filesize taking in account shrink/growing thresholds */
+ if (meta->mm_geo.next > meta->mm_geo.now) {
+ const pgno_t aligned = pgno_align2os_pgno(
+ env,
+ pgno_add(meta->mm_geo.next,
+ meta->mm_geo.grow - meta->mm_geo.next % meta->mm_geo.grow));
+ meta->mm_geo.now = aligned;
+ } else if (meta->mm_geo.next < meta->mm_geo.now) {
+ meta->mm_geo.now = meta->mm_geo.next;
+ const pgno_t aligner =
+ meta->mm_geo.grow ? meta->mm_geo.grow : meta->mm_geo.shrink;
+ const pgno_t aligned = pgno_align2os_pgno(
+ env, meta->mm_geo.next + aligner - meta->mm_geo.next % aligner);
+ meta->mm_geo.now = aligned;
+ }
+
+ if (meta->mm_geo.now < meta->mm_geo.lower)
+ meta->mm_geo.now = meta->mm_geo.lower;
+ if (meta->mm_geo.now > meta->mm_geo.upper)
+ meta->mm_geo.now = meta->mm_geo.upper;
+
+ /* Update signature */
+ assert(meta->mm_geo.now >= meta->mm_geo.next);
+ meta->mm_datasync_sign = mdbx_meta_sign(meta);
+}
+
+/* Copy environment with compaction. */
+static int __cold mdbx_env_compact(MDBX_env *env, MDBX_txn *read_txn,
+ mdbx_filehandle_t fd, uint8_t *buffer,
+ const bool dest_is_pipe) {
+ const size_t meta_bytes = pgno2bytes(env, NUM_METAS);
+ uint8_t *const data_buffer =
+ buffer + roundup_powerof2(meta_bytes, env->me_os_psize);
+ MDBX_meta *const meta = mdbx_init_metas(env, buffer);
+ /* copy canary sequenses if present */
+ if (read_txn->mt_canary.v) {
+ meta->mm_canary = read_txn->mt_canary;
+ meta->mm_canary.v = mdbx_meta_txnid_stable(env, meta);
+ }
+
+ /* Set metapage 1 with current main DB */
+ pgno_t new_root, root = read_txn->mt_dbs[MAIN_DBI].md_root;
+ if ((new_root = root) == P_INVALID) {
+ /* When the DB is empty, handle it specially to
+ * fix any breakage like page leaks from ITS#8174. */
+ meta->mm_dbs[MAIN_DBI].md_flags = read_txn->mt_dbs[MAIN_DBI].md_flags;
+ compact_fixup_meta(env, meta);
+ if (dest_is_pipe) {
+ int rc = mdbx_write(fd, buffer, meta_bytes);
+ if (rc != MDBX_SUCCESS)
+ return rc;
+ }
+ } else {
+ /* Count free pages + GC pages. Subtract from last_pg
+ * to find the new last_pg, which also becomes the new root. */
+ pgno_t freecount = 0;
+ MDBX_cursor mc;
+ MDBX_val key, data;
+
+ int rc = mdbx_cursor_init(&mc, read_txn, FREE_DBI);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+ while ((rc = mdbx_cursor_get(&mc, &key, &data, MDBX_NEXT)) == 0)
+ freecount += *(pgno_t *)data.iov_base;
+ if (unlikely(rc != MDBX_NOTFOUND))
+ return rc;
+
+ freecount += read_txn->mt_dbs[FREE_DBI].md_branch_pages +
+ read_txn->mt_dbs[FREE_DBI].md_leaf_pages +
+ read_txn->mt_dbs[FREE_DBI].md_overflow_pages;
+
+ new_root = read_txn->mt_next_pgno - 1 - freecount;
+ meta->mm_geo.next = new_root + 1;
+ meta->mm_dbs[MAIN_DBI] = read_txn->mt_dbs[MAIN_DBI];
+ meta->mm_dbs[MAIN_DBI].md_root = new_root;
+
+ mdbx_copy ctx;
+ memset(&ctx, 0, sizeof(ctx));
+ rc = mdbx_condmutex_init(&ctx.mc_condmutex);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ memset(data_buffer, 0, MDBX_WBUF * 2);
+ ctx.mc_wbuf[0] = data_buffer;
+ ctx.mc_wbuf[1] = data_buffer + MDBX_WBUF;
+ ctx.mc_next_pgno = NUM_METAS;
+ ctx.mc_env = env;
+ ctx.mc_fd = fd;
+ ctx.mc_txn = read_txn;
+
+ mdbx_thread_t thread;
+ int thread_err = mdbx_thread_create(&thread, mdbx_env_copythr, &ctx);
+ if (likely(thread_err == MDBX_SUCCESS)) {
+ if (dest_is_pipe) {
+ compact_fixup_meta(env, meta);
+ rc = mdbx_write(fd, buffer, meta_bytes);
+ }
+ if (rc == MDBX_SUCCESS)
+ rc = mdbx_env_cwalk(&ctx, &root, 0);
+ mdbx_env_cthr_toggle(&ctx, 1 | MDBX_EOF);
+ thread_err = mdbx_thread_join(thread);
+ mdbx_condmutex_destroy(&ctx.mc_condmutex);
+ }
+ if (unlikely(thread_err != MDBX_SUCCESS))
+ return thread_err;
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+ if (unlikely(ctx.mc_error != MDBX_SUCCESS))
+ return ctx.mc_error;
+
+ if (dest_is_pipe) {
+ if (root != new_root) {
+ mdbx_error("post-compactification root %" PRIaPGNO
+ " NE expected %" PRIaPGNO
+ " (source DB corrupted or has a page leak(s))",
+ root, new_root);
+ return MDBX_CORRUPTED; /* page leak or corrupt DB */
+ }
+ } else {
+ if (root > new_root) {
+ mdbx_error("post-compactification root %" PRIaPGNO
+ " GT expected %" PRIaPGNO " (source DB corrupted)",
+ root, new_root);
+ return MDBX_CORRUPTED; /* page leak or corrupt DB */
+ }
+ if (root < new_root) {
+ mdbx_notice("post-compactification root %" PRIaPGNO
+ " LT expected %" PRIaPGNO " (page leak(s) in source DB)",
+ root, new_root);
+ /* fixup meta */
+ meta->mm_dbs[MAIN_DBI].md_root = root;
+ meta->mm_geo.next = root + 1;
+ }
+ compact_fixup_meta(env, meta);
+ }
+ }
+
+ /* Extend file if required */
+ if (meta->mm_geo.now != meta->mm_geo.next) {
+ const size_t whole_size = pgno2bytes(env, meta->mm_geo.now);
+ if (!dest_is_pipe)
+ return mdbx_ftruncate(fd, whole_size);
+
+ const size_t used_size = pgno2bytes(env, meta->mm_geo.next);
+ memset(data_buffer, 0, MDBX_WBUF);
+ for (size_t offset = used_size; offset < whole_size;) {
+ const size_t chunk =
+ (MDBX_WBUF < whole_size - offset) ? MDBX_WBUF : whole_size - offset;
+ /* copy to avoit EFAULT in case swapped-out */
+ int rc = mdbx_write(fd, data_buffer, chunk);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+ offset += chunk;
+ }
+ }
+ return MDBX_SUCCESS;
+}
+
+/* Copy environment as-is. */
+static int __cold mdbx_env_copy_asis(MDBX_env *env, MDBX_txn *read_txn,
+ mdbx_filehandle_t fd, uint8_t *buffer,
+ const bool dest_is_pipe) {
+ /* We must start the actual read txn after blocking writers */
+ int rc = mdbx_txn_end(read_txn, MDBX_END_RESET_TMP);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ /* Temporarily block writers until we snapshot the meta pages */
+ rc = mdbx_txn_lock(env, false);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ rc = mdbx_txn_renew0(read_txn, MDBX_RDONLY);
+ if (unlikely(rc != MDBX_SUCCESS)) {
+ mdbx_txn_unlock(env);
+ return rc;
+ }
+
+ mdbx_jitter4testing(false);
+ const size_t meta_bytes = pgno2bytes(env, NUM_METAS);
+ /* Make a snapshot of meta-pages,
+ * but writing ones after the data was flushed */
+ memcpy(buffer, env->me_map, meta_bytes);
+ MDBX_meta *const headcopy = /* LY: get pointer to the spanshot copy */
+ (MDBX_meta *)(buffer + ((uint8_t *)mdbx_meta_head(env) - env->me_map));
+ /* Update signature to steady */
+ headcopy->mm_datasync_sign = mdbx_meta_sign(headcopy);
+ mdbx_txn_unlock(env);
+
+ /* Copy the data */
+ const size_t whole_size = pgno_align2os_bytes(env, read_txn->mt_end_pgno);
+ const size_t used_size = pgno2bytes(env, read_txn->mt_next_pgno);
+ mdbx_jitter4testing(false);
+
+ if (dest_is_pipe)
+ rc = mdbx_write(fd, buffer, meta_bytes);
+
+ uint8_t *const data_buffer =
+ buffer + roundup_powerof2(meta_bytes, env->me_os_psize);
+ for (size_t offset = meta_bytes; rc == MDBX_SUCCESS && offset < used_size;) {
+ if (dest_is_pipe) {
+#if defined(__linux__) || defined(__gnu_linux__)
+ off_t in_offset = offset;
+ const intptr_t written =
+ sendfile(fd, env->me_fd, &in_offset, used_size - offset);
+ if (unlikely(written <= 0)) {
+ rc = written ? errno : MDBX_ENODATA;
+ break;
+ }
+ offset = in_offset;
+ continue;
+#endif
+ } else {
+#if __GLIBC_PREREQ(2, 27) && defined(_GNU_SOURCE)
+ off_t in_offset = offset, out_offset = offset;
+ ssize_t bytes_copied = copy_file_range(
+ env->me_fd, &in_offset, fd, &out_offset, used_size - offset, 0);
+ if (unlikely(bytes_copied <= 0)) {
+ rc = bytes_copied ? errno : MDBX_ENODATA;
+ break;
+ }
+ offset = in_offset;
+ continue;
+#endif
+ }
+
+ /* fallback to portable */
+ const size_t chunk =
+ (MDBX_WBUF < used_size - offset) ? MDBX_WBUF : used_size - offset;
+ /* copy to avoit EFAULT in case swapped-out */
+ memcpy(data_buffer, env->me_map + offset, chunk);
+ rc = mdbx_write(fd, data_buffer, chunk);
+ offset += chunk;
+ }
+
+ /* Extend file if required */
+ if (likely(rc == MDBX_SUCCESS) && whole_size != used_size) {
+ if (!dest_is_pipe)
+ rc = mdbx_ftruncate(fd, whole_size);
+ else {
+ memset(data_buffer, 0, MDBX_WBUF);
+ for (size_t offset = used_size;
+ rc == MDBX_SUCCESS && offset < whole_size;) {
+ const size_t chunk =
+ (MDBX_WBUF < whole_size - offset) ? MDBX_WBUF : whole_size - offset;
+ /* copy to avoit EFAULT in case swapped-out */
+ rc = mdbx_write(fd, data_buffer, chunk);
+ offset += chunk;
+ }
+ }
+ }
+
+ return rc;
+}
+
+int __cold mdbx_env_copy2fd(MDBX_env *env, mdbx_filehandle_t fd,
+ unsigned flags) {
+ if (unlikely(!env))
+ return MDBX_EINVAL;
+
+ if (unlikely(env->me_signature != MDBX_ME_SIGNATURE))
+ return MDBX_EBADSIGN;
+
+ const int dest_is_pipe = mdbx_is_pipe(fd);
+ if (MDBX_IS_ERROR(dest_is_pipe))
+ return dest_is_pipe;
+
+ if (!dest_is_pipe) {
+ int rc = mdbx_fseek(fd, 0);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+ }
+
+ const size_t buffer_size =
+ pgno_align2os_bytes(env, NUM_METAS) +
+ roundup_powerof2(((flags & MDBX_CP_COMPACT) ? MDBX_WBUF * 2 : MDBX_WBUF),
+ env->me_os_psize);
+
+ uint8_t *buffer = NULL;
+ int rc = mdbx_memalign_alloc(env->me_os_psize, buffer_size, (void **)&buffer);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ MDBX_txn *read_txn = NULL;
+ /* Do the lock/unlock of the reader mutex before starting the
+ * write txn. Otherwise other read txns could block writers. */
+ rc = mdbx_txn_begin(env, NULL, MDBX_RDONLY, &read_txn);
+ if (unlikely(rc != MDBX_SUCCESS)) {
+ mdbx_memalign_free(buffer);
+ return rc;
+ }
+
+ if (!dest_is_pipe) {
+ /* Firstly write a stub to meta-pages.
+ * Now we sure to incomplete copy will not be used. */
+ memset(buffer, -1, pgno2bytes(env, NUM_METAS));
+ rc = mdbx_write(fd, buffer, pgno2bytes(env, NUM_METAS));
+ }
+
+ if (likely(rc == MDBX_SUCCESS)) {
+ memset(buffer, 0, pgno2bytes(env, NUM_METAS));
+ rc = (flags & MDBX_CP_COMPACT)
+ ? mdbx_env_compact(env, read_txn, fd, buffer, dest_is_pipe)
+ : mdbx_env_copy_asis(env, read_txn, fd, buffer, dest_is_pipe);
+ }
+ mdbx_txn_abort(read_txn);
+
+ if (!dest_is_pipe) {
+ if (likely(rc == MDBX_SUCCESS))
+ rc = mdbx_filesync(fd, MDBX_SYNC_DATA | MDBX_SYNC_SIZE | MDBX_SYNC_IODQ);
+
+ /* Write actual meta */
+ if (likely(rc == MDBX_SUCCESS))
+ rc = mdbx_pwrite(fd, buffer, pgno2bytes(env, NUM_METAS), 0);
+
+ if (likely(rc == MDBX_SUCCESS))
+ rc = mdbx_filesync(fd, MDBX_SYNC_DATA | MDBX_SYNC_IODQ);
+ }
+
+ mdbx_memalign_free(buffer);
+ return rc;
+}
+
+int __cold mdbx_env_copy(MDBX_env *env, const char *dest_path, unsigned flags) {
+ if (unlikely(!env || !dest_path))
+ return MDBX_EINVAL;
+
+ if (unlikely(env->me_signature != MDBX_ME_SIGNATURE))
+ return MDBX_EBADSIGN;
+
+ char *dxb_pathname;
+ mdbx_filehandle_t newfd = INVALID_HANDLE_VALUE;
+
+ if (env->me_flags & MDBX_NOSUBDIR) {
+ dxb_pathname = (char *)dest_path;
+ } else {
+ size_t len = strlen(dest_path);
+ len += sizeof(MDBX_DATANAME);
+ dxb_pathname = mdbx_malloc(len);
+ if (!dxb_pathname)
+ return MDBX_ENOMEM;
+ sprintf(dxb_pathname, "%s" MDBX_DATANAME, dest_path);
+ }
+
+ /* The destination path must exist, but the destination file must not.
+ * We don't want the OS to cache the writes, since the source data is
+ * already in the OS cache. */
+ int rc = mdbx_openfile(dxb_pathname, O_WRONLY | O_CREAT | O_EXCL, 0640,
+ &newfd, true);
+ if (rc == MDBX_SUCCESS) {
+ if (env->me_psize >= env->me_os_psize) {
+#ifdef F_NOCACHE /* __APPLE__ */
+ (void)fcntl(newfd, F_NOCACHE, 1);
+#elif defined(O_DIRECT) && defined(F_GETFL)
+ /* Set O_DIRECT if the file system supports it */
+ if ((rc = fcntl(newfd, F_GETFL)) != -1)
+ (void)fcntl(newfd, F_SETFL, rc | O_DIRECT);
+#endif
+ }
+ rc = mdbx_env_copy2fd(env, newfd, flags);
+ }
+
+ if (newfd != INVALID_HANDLE_VALUE) {
+ int err = mdbx_closefile(newfd);
+ if (rc == MDBX_SUCCESS && err != rc)
+ rc = err;
+ if (rc != MDBX_SUCCESS)
+ (void)mdbx_removefile(dxb_pathname);
+ }
+
+ if (dxb_pathname != dest_path)
+ mdbx_free(dxb_pathname);
+
+ return rc;
+}
+
+/******************************************************************************/
+
+int __cold mdbx_env_set_flags(MDBX_env *env, unsigned flags, int onoff) {
+ if (unlikely(!env))
+ return MDBX_EINVAL;
+
+ if (unlikely(env->me_signature != MDBX_ME_SIGNATURE))
+ return MDBX_EBADSIGN;
+
+ if (unlikely(flags & ~CHANGEABLE))
+ return MDBX_EPERM;
+
+ if (unlikely(env->me_flags & MDBX_RDONLY))
+ return MDBX_EACCESS;
+
+ if (unlikely(env->me_txn0->mt_owner == mdbx_thread_self()))
+ return MDBX_BUSY;
+
+ int rc = mdbx_txn_lock(env, false);
+ if (unlikely(rc))
+ return rc;
+
+ if (onoff)
+ env->me_flags |= flags;
+ else
+ env->me_flags &= ~flags;
+
+ mdbx_txn_unlock(env);
+ return MDBX_SUCCESS;
+}
+
+int __cold mdbx_env_get_flags(MDBX_env *env, unsigned *arg) {
+ if (unlikely(!env || !arg))
+ return MDBX_EINVAL;
+
+ if (unlikely(env->me_signature != MDBX_ME_SIGNATURE))
+ return MDBX_EBADSIGN;
+
+ *arg = env->me_flags & (CHANGEABLE | CHANGELESS);
+ return MDBX_SUCCESS;
+}
+
+int __cold mdbx_env_set_userctx(MDBX_env *env, void *ctx) {
+ if (unlikely(!env))
+ return MDBX_EINVAL;
+
+ if (unlikely(env->me_signature != MDBX_ME_SIGNATURE))
+ return MDBX_EBADSIGN;
+
+ env->me_userctx = ctx;
+ return MDBX_SUCCESS;
+}
+
+void *__cold mdbx_env_get_userctx(MDBX_env *env) {
+ return env ? env->me_userctx : NULL;
+}
+
+int __cold mdbx_env_set_assert(MDBX_env *env, MDBX_assert_func *func) {
+ if (unlikely(!env))
+ return MDBX_EINVAL;
+
+ if (unlikely(env->me_signature != MDBX_ME_SIGNATURE))
+ return MDBX_EBADSIGN;
+
+#if MDBX_DEBUG
+ env->me_assert_func = func;
+ return MDBX_SUCCESS;
+#else
+ (void)func;
+ return MDBX_ENOSYS;
+#endif
+}
+
+int __cold mdbx_env_get_path(MDBX_env *env, const char **arg) {
+ if (unlikely(!env || !arg))
+ return MDBX_EINVAL;
+
+ if (unlikely(env->me_signature != MDBX_ME_SIGNATURE))
+ return MDBX_EBADSIGN;
+
+ *arg = env->me_path;
+ return MDBX_SUCCESS;
+}
+
+int __cold mdbx_env_get_fd(MDBX_env *env, mdbx_filehandle_t *arg) {
+ if (unlikely(!env || !arg))
+ return MDBX_EINVAL;
+
+ if (unlikely(env->me_signature != MDBX_ME_SIGNATURE))
+ return MDBX_EBADSIGN;
+
+ *arg = env->me_fd;
+ return MDBX_SUCCESS;
+}
+
+/* Common code for mdbx_dbi_stat() and mdbx_env_stat().
+ * [in] env the environment to operate in.
+ * [in] db the MDBX_db record containing the stats to return.
+ * [out] arg the address of an MDBX_stat structure to receive the stats.
+ * Returns 0, this function always succeeds. */
+static void mdbx_stat0(const MDBX_env *env, const MDBX_db *db, MDBX_stat *dest,
+ size_t bytes) {
+ dest->ms_psize = env->me_psize;
+ dest->ms_depth = db->md_depth;
+ dest->ms_branch_pages = db->md_branch_pages;
+ dest->ms_leaf_pages = db->md_leaf_pages;
+ dest->ms_overflow_pages = db->md_overflow_pages;
+ dest->ms_entries = db->md_entries;
+ if (likely(bytes >=
+ offsetof(MDBX_stat, ms_mod_txnid) + sizeof(dest->ms_mod_txnid)))
+ dest->ms_mod_txnid = db->md_mod_txnid;
+}
+
+int __cold mdbx_env_stat(MDBX_env *env, MDBX_stat *dest, size_t bytes) {
+ return mdbx_env_stat_ex(env, NULL, dest, bytes);
+}
+
+int __cold mdbx_env_stat_ex(const MDBX_env *env, const MDBX_txn *txn,
+ MDBX_stat *dest, size_t bytes) {
+ if (unlikely((env == NULL && txn == NULL) || dest == NULL))
+ return MDBX_EINVAL;
+
+ if (txn) {
+ int err = check_txn(txn, MDBX_TXN_BLOCKED);
+ if (unlikely(err != MDBX_SUCCESS))
+ return err;
+ }
+ if (env) {
+ if (unlikely(env->me_signature != MDBX_ME_SIGNATURE))
+ return MDBX_EBADSIGN;
+ if (txn && unlikely(txn->mt_env != env))
+ return MDBX_EINVAL;
+ }
+
+ const size_t size_before_modtxnid = offsetof(MDBX_stat, ms_mod_txnid);
+ if (unlikely(bytes != sizeof(MDBX_stat)) && bytes != size_before_modtxnid)
+ return MDBX_EINVAL;
+
+ if (txn) {
+ mdbx_stat0(txn->mt_env, &txn->mt_dbs[MAIN_DBI], dest, bytes);
+ return MDBX_SUCCESS;
+ }
+
+ while (1) {
+ const MDBX_meta *const recent_meta = mdbx_meta_head(env);
+ const txnid_t txnid = mdbx_meta_txnid_fluid(env, recent_meta);
+ mdbx_stat0(env, &recent_meta->mm_dbs[MAIN_DBI], dest, bytes);
+ mdbx_compiler_barrier();
+ if (likely(txnid == mdbx_meta_txnid_fluid(env, recent_meta) &&
+ recent_meta == mdbx_meta_head(env)))
+ return MDBX_SUCCESS;
+ }
+}
+
+int __cold mdbx_env_info(MDBX_env *env, MDBX_envinfo *arg, size_t bytes) {
+ return mdbx_env_info_ex(env, NULL, arg, bytes);
+}
+
+int __cold mdbx_env_info_ex(const MDBX_env *env, const MDBX_txn *txn,
+ MDBX_envinfo *arg, size_t bytes) {
+ if (unlikely((env == NULL && txn == NULL) || arg == NULL))
+ return MDBX_EINVAL;
+
+ if (txn) {
+ int err = check_txn(txn, MDBX_TXN_BLOCKED);
+ if (unlikely(err != MDBX_SUCCESS))
+ return err;
+ }
+ if (env) {
+ if (unlikely(env->me_signature != MDBX_ME_SIGNATURE))
+ return MDBX_EBADSIGN;
+ if (txn && unlikely(txn->mt_env != env))
+ return MDBX_EINVAL;
+ } else {
+ env = txn->mt_env;
+ }
+
+ const size_t size_before_bootid = offsetof(MDBX_envinfo, mi_bootid);
+ if (unlikely(bytes != sizeof(MDBX_envinfo)) && bytes != size_before_bootid)
+ return MDBX_EINVAL;
+
+ const MDBX_meta *const meta0 = METAPAGE(env, 0);
+ const MDBX_meta *const meta1 = METAPAGE(env, 1);
+ const MDBX_meta *const meta2 = METAPAGE(env, 2);
+ pgno_t unsynced_pages;
+ while (1) {
+ if (unlikely(env->me_flags & MDBX_FATAL_ERROR))
+ return MDBX_PANIC;
+
+ const MDBX_meta *const recent_meta = mdbx_meta_head(env);
+ arg->mi_recent_txnid = mdbx_meta_txnid_fluid(env, recent_meta);
+ arg->mi_meta0_txnid = mdbx_meta_txnid_fluid(env, meta0);
+ arg->mi_meta0_sign = meta0->mm_datasync_sign;
+ arg->mi_meta1_txnid = mdbx_meta_txnid_fluid(env, meta1);
+ arg->mi_meta1_sign = meta1->mm_datasync_sign;
+ arg->mi_meta2_txnid = mdbx_meta_txnid_fluid(env, meta2);
+ arg->mi_meta2_sign = meta2->mm_datasync_sign;
+
+ const MDBX_meta *txn_meta = recent_meta;
+ arg->mi_last_pgno = txn_meta->mm_geo.next - 1;
+ arg->mi_geo.current = pgno2bytes(env, txn_meta->mm_geo.now);
+ if (txn) {
+ arg->mi_last_pgno = txn->mt_next_pgno - 1;
+ arg->mi_geo.current = pgno2bytes(env, txn->mt_end_pgno);
+
+ const txnid_t wanna_meta_txnid = (txn->mt_flags & MDBX_RDONLY)
+ ? txn->mt_txnid
+ : txn->mt_txnid - MDBX_TXNID_STEP;
+ txn_meta = (arg->mi_meta0_txnid == wanna_meta_txnid) ? meta0 : txn_meta;
+ txn_meta = (arg->mi_meta1_txnid == wanna_meta_txnid) ? meta1 : txn_meta;
+ txn_meta = (arg->mi_meta2_txnid == wanna_meta_txnid) ? meta2 : txn_meta;
+ }
+ arg->mi_geo.lower = pgno2bytes(env, txn_meta->mm_geo.lower);
+ arg->mi_geo.upper = pgno2bytes(env, txn_meta->mm_geo.upper);
+ arg->mi_geo.shrink = pgno2bytes(env, txn_meta->mm_geo.shrink);
+ arg->mi_geo.grow = pgno2bytes(env, txn_meta->mm_geo.grow);
+ unsynced_pages = *env->me_unsynced_pages +
+ (*env->me_meta_sync_txnid != (uint32_t)arg->mi_last_pgno);
+
+ arg->mi_mapsize = env->me_dxb_mmap.limit;
+ mdbx_compiler_barrier();
+ if (likely(arg->mi_meta0_txnid == mdbx_meta_txnid_fluid(env, meta0) &&
+ arg->mi_meta0_sign == meta0->mm_datasync_sign &&
+ arg->mi_meta1_txnid == mdbx_meta_txnid_fluid(env, meta1) &&
+ arg->mi_meta1_sign == meta1->mm_datasync_sign &&
+ arg->mi_meta2_txnid == mdbx_meta_txnid_fluid(env, meta2) &&
+ arg->mi_meta2_sign == meta2->mm_datasync_sign &&
+ recent_meta == mdbx_meta_head(env) &&
+ arg->mi_recent_txnid == mdbx_meta_txnid_fluid(env, recent_meta)))
+ break;
+ }
+
+ arg->mi_maxreaders = env->me_maxreaders;
+ arg->mi_numreaders = env->me_lck ? env->me_lck->mti_numreaders : INT32_MAX;
+ arg->mi_dxb_pagesize = env->me_psize;
+ arg->mi_sys_pagesize = env->me_os_psize;
+
+ const MDBX_lockinfo *const lck = env->me_lck;
+ if (likely(bytes > size_before_bootid)) {
+ arg->mi_unsync_volume = pgno2bytes(env, unsynced_pages);
+ const uint64_t monotime_now = mdbx_osal_monotime();
+ arg->mi_since_sync_seconds16dot16 =
+ mdbx_osal_monotime_to_16dot16(monotime_now - *env->me_sync_timestamp);
+ arg->mi_since_reader_check_seconds16dot16 =
+ lck ? mdbx_osal_monotime_to_16dot16(monotime_now -
+ lck->mti_reader_check_timestamp)
+ : 0;
+ arg->mi_autosync_threshold = pgno2bytes(env, *env->me_autosync_threshold);
+ arg->mi_autosync_period_seconds16dot16 =
+ mdbx_osal_monotime_to_16dot16(*env->me_autosync_period);
+ arg->mi_bootid[0] = lck ? lck->mti_bootid.x : 0;
+ arg->mi_bootid[1] = lck ? lck->mti_bootid.y : 0;
+ arg->mi_mode = lck ? lck->mti_envmode : env->me_flags;
+ }
+
+ arg->mi_self_latter_reader_txnid = arg->mi_latter_reader_txnid = 0;
+ if (lck) {
+ arg->mi_self_latter_reader_txnid = arg->mi_latter_reader_txnid =
+ arg->mi_recent_txnid;
+ for (unsigned i = 0; i < arg->mi_numreaders; ++i) {
+ const uint32_t pid = lck->mti_readers[i].mr_pid;
+ if (pid) {
+ const txnid_t txnid = safe64_read(&lck->mti_readers[i].mr_txnid);
+ if (arg->mi_latter_reader_txnid > txnid)
+ arg->mi_latter_reader_txnid = txnid;
+ if (pid == env->me_pid && arg->mi_self_latter_reader_txnid > txnid)
+ arg->mi_self_latter_reader_txnid = txnid;
+ }
+ }
+ }
+
+ return MDBX_SUCCESS;
+}
+
+static MDBX_cmp_func *mdbx_default_keycmp(unsigned flags) {
+ return (flags & MDBX_REVERSEKEY)
+ ? mdbx_cmp_memnr
+ : (flags & MDBX_INTEGERKEY) ? mdbx_cmp_int_align2 : mdbx_cmp_memn;
+}
+
+static MDBX_cmp_func *mdbx_default_datacmp(unsigned flags) {
+ return !(flags & MDBX_DUPSORT)
+ ? mdbx_cmp_memn
+ : ((flags & MDBX_INTEGERDUP)
+ ? mdbx_cmp_int_unaligned
+ : ((flags & MDBX_REVERSEDUP) ? mdbx_cmp_memnr
+ : mdbx_cmp_memn));
+}
+
+static int mdbx_dbi_bind(MDBX_txn *txn, const MDBX_dbi dbi, unsigned user_flags,
+ MDBX_cmp_func *keycmp, MDBX_cmp_func *datacmp) {
+ /* LY: so, accepting only three cases for the table's flags:
+ * 1) user_flags and both comparators are zero
+ * = assume that a by-default mode/flags is requested for reading;
+ * 2) user_flags exactly the same
+ * = assume that the target mode/flags are requested properly;
+ * 3) user_flags differs, but table is empty and MDBX_CREATE is provided
+ * = assume that a properly create request with custom flags;
+ */
+ if ((user_flags ^ txn->mt_dbs[dbi].md_flags) & PERSISTENT_FLAGS) {
+ /* flags ara differs, check other conditions */
+ if (!user_flags && (!keycmp || keycmp == txn->mt_dbxs[dbi].md_cmp) &&
+ (!datacmp || datacmp == txn->mt_dbxs[dbi].md_dcmp)) {
+ /* no comparators were provided and flags are zero,
+ * seems that is case #1 above */
+ user_flags = txn->mt_dbs[dbi].md_flags;
+ } else if ((user_flags & MDBX_CREATE) && txn->mt_dbs[dbi].md_entries == 0) {
+ if (txn->mt_flags & MDBX_RDONLY)
+ return /* FIXME: return extended info */ MDBX_EACCESS;
+ /* make sure flags changes get committed */
+ txn->mt_dbs[dbi].md_flags = user_flags & PERSISTENT_FLAGS;
+ txn->mt_flags |= MDBX_TXN_DIRTY;
+ } else {
+ return /* FIXME: return extended info */ MDBX_INCOMPATIBLE;
+ }
+ }
+
+ if (!txn->mt_dbxs[dbi].md_cmp || MDBX_DEBUG) {
+ if (!keycmp)
+ keycmp = mdbx_default_keycmp(user_flags);
+ mdbx_tassert(txn, !txn->mt_dbxs[dbi].md_cmp ||
+ txn->mt_dbxs[dbi].md_cmp == keycmp);
+ txn->mt_dbxs[dbi].md_cmp = keycmp;
+ }
+
+ if (!txn->mt_dbxs[dbi].md_dcmp || MDBX_DEBUG) {
+ if (!datacmp)
+ datacmp = mdbx_default_datacmp(user_flags);
+ mdbx_tassert(txn, !txn->mt_dbxs[dbi].md_dcmp ||
+ txn->mt_dbxs[dbi].md_dcmp == datacmp);
+ txn->mt_dbxs[dbi].md_dcmp = datacmp;
+ }
+
+ return MDBX_SUCCESS;
+}
+
+int mdbx_dbi_open_ex(MDBX_txn *txn, const char *table_name, unsigned user_flags,
+ MDBX_dbi *dbi, MDBX_cmp_func *keycmp,
+ MDBX_cmp_func *datacmp) {
+ int rc = check_txn(txn, MDBX_TXN_BLOCKED);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ if (unlikely(!dbi || (user_flags & ~VALID_FLAGS) != 0))
+ return MDBX_EINVAL;
+
+ switch (user_flags &
+ (MDBX_INTEGERDUP | MDBX_DUPFIXED | MDBX_DUPSORT | MDBX_REVERSEDUP)) {
+ default:
+ return MDBX_EINVAL;
+ case MDBX_DUPSORT:
+ case MDBX_DUPSORT | MDBX_REVERSEDUP:
+ case MDBX_DUPSORT | MDBX_DUPFIXED:
+ case MDBX_DUPSORT | MDBX_DUPFIXED | MDBX_REVERSEDUP:
+ case MDBX_DUPSORT | MDBX_DUPFIXED | MDBX_INTEGERDUP:
+ case MDBX_DUPSORT | MDBX_DUPFIXED | MDBX_INTEGERDUP | MDBX_REVERSEDUP:
+ case 0:
+ break;
+ }
+
+ /* main table? */
+ if (!table_name) {
+ *dbi = MAIN_DBI;
+ return mdbx_dbi_bind(txn, MAIN_DBI, user_flags, keycmp, datacmp);
+ }
+
+ if (txn->mt_dbxs[MAIN_DBI].md_cmp == NULL) {
+ txn->mt_dbxs[MAIN_DBI].md_cmp =
+ mdbx_default_keycmp(txn->mt_dbs[MAIN_DBI].md_flags);
+ txn->mt_dbxs[MAIN_DBI].md_dcmp =
+ mdbx_default_datacmp(txn->mt_dbs[MAIN_DBI].md_flags);
+ }
+
+ /* Is the DB already open? */
+ size_t len = strlen(table_name);
+ MDBX_dbi scan, slot;
+ for (slot = scan = txn->mt_numdbs; --scan >= CORE_DBS;) {
+ if (!txn->mt_dbxs[scan].md_name.iov_len) {
+ /* Remember this free slot */
+ slot = scan;
+ continue;
+ }
+ if (len == txn->mt_dbxs[scan].md_name.iov_len &&
+ !strncmp(table_name, txn->mt_dbxs[scan].md_name.iov_base, len)) {
+ *dbi = scan;
+ return mdbx_dbi_bind(txn, scan, user_flags, keycmp, datacmp);
+ }
+ }
+
+ /* Fail, if no free slot and max hit */
+ MDBX_env *env = txn->mt_env;
+ if (unlikely(slot >= env->me_maxdbs))
+ return MDBX_DBS_FULL;
+
+ /* Cannot mix named table with some main-table flags */
+ if (unlikely(txn->mt_dbs[MAIN_DBI].md_flags &
+ (MDBX_DUPSORT | MDBX_INTEGERKEY)))
+ return (user_flags & MDBX_CREATE) ? MDBX_INCOMPATIBLE : MDBX_NOTFOUND;
+
+ /* Find the DB info */
+ int exact = 0;
+ MDBX_val key, data;
+ key.iov_len = len;
+ key.iov_base = (void *)table_name;
+ MDBX_cursor mc;
+ rc = mdbx_cursor_init(&mc, txn, MAIN_DBI);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+ rc = mdbx_cursor_set(&mc, &key, &data, MDBX_SET, &exact);
+ if (unlikely(rc != MDBX_SUCCESS)) {
+ if (rc != MDBX_NOTFOUND || !(user_flags & MDBX_CREATE))
+ return rc;
+ } else {
+ /* make sure this is actually a table */
+ MDBX_node *node = page_node(mc.mc_pg[mc.mc_top], mc.mc_ki[mc.mc_top]);
+ if (unlikely((node_flags(node) & (F_DUPDATA | F_SUBDATA)) != F_SUBDATA))
+ return MDBX_INCOMPATIBLE;
+ if (unlikely(data.iov_len < sizeof(MDBX_db)))
+ return MDBX_CORRUPTED;
+ }
+
+ if (rc != MDBX_SUCCESS && unlikely(txn->mt_flags & MDBX_RDONLY))
+ return MDBX_EACCESS;
+
+ /* Done here so we cannot fail after creating a new DB */
+ char *namedup = mdbx_strdup(table_name);
+ if (unlikely(!namedup))
+ return MDBX_ENOMEM;
+
+ int err = mdbx_fastmutex_acquire(&env->me_dbi_lock);
+ if (unlikely(err != MDBX_SUCCESS)) {
+ mdbx_free(namedup);
+ return err;
+ }
+
+ if (txn->mt_numdbs < env->me_numdbs) {
+ for (unsigned i = txn->mt_numdbs; i < env->me_numdbs; ++i) {
+ txn->mt_dbflags[i] = 0;
+ if (env->me_dbflags[i] & MDBX_VALID) {
+ txn->mt_dbs[i].md_flags = env->me_dbflags[i] & PERSISTENT_FLAGS;
+ txn->mt_dbflags[i] = DB_VALID | DB_USRVALID | DB_STALE;
+ mdbx_tassert(txn, txn->mt_dbxs[i].md_cmp != NULL);
+ }
+ }
+ txn->mt_numdbs = env->me_numdbs;
+ }
+
+ for (slot = scan = txn->mt_numdbs; --scan >= CORE_DBS;) {
+ if (!txn->mt_dbxs[scan].md_name.iov_len) {
+ /* Remember this free slot */
+ slot = scan;
+ continue;
+ }
+ if (len == txn->mt_dbxs[scan].md_name.iov_len &&
+ !strncmp(table_name, txn->mt_dbxs[scan].md_name.iov_base, len)) {
+ *dbi = scan;
+ rc = mdbx_dbi_bind(txn, scan, user_flags, keycmp, datacmp);
+ goto bailout;
+ }
+ }
+
+ if (unlikely(slot >= env->me_maxdbs)) {
+ rc = MDBX_DBS_FULL;
+ goto bailout;
+ }
+
+ unsigned dbflag = DB_FRESH | DB_VALID | DB_USRVALID;
+ MDBX_db db_dummy;
+ if (unlikely(rc)) {
+ /* MDBX_NOTFOUND and MDBX_CREATE: Create new DB */
+ mdbx_tassert(txn, rc == MDBX_NOTFOUND);
+ memset(&db_dummy, 0, sizeof(db_dummy));
+ db_dummy.md_root = P_INVALID;
+ db_dummy.md_flags = user_flags & PERSISTENT_FLAGS;
+ data.iov_len = sizeof(db_dummy);
+ data.iov_base = &db_dummy;
+ WITH_CURSOR_TRACKING(
+ mc,
+ rc = mdbx_cursor_put(&mc, &key, &data, F_SUBDATA | MDBX_NOOVERWRITE));
+
+ if (unlikely(rc != MDBX_SUCCESS))
+ goto bailout;
+
+ dbflag |= DB_DIRTY | DB_CREAT;
+ }
+
+ /* Got info, register DBI in this txn */
+ txn->mt_dbxs[slot].md_cmp = nullptr;
+ txn->mt_dbxs[slot].md_dcmp = nullptr;
+ txn->mt_dbs[slot] = *(MDBX_db *)data.iov_base;
+ env->me_dbflags[slot] = 0;
+ rc = mdbx_dbi_bind(txn, slot, user_flags, keycmp, datacmp);
+ if (unlikely(rc != MDBX_SUCCESS)) {
+ mdbx_tassert(txn, (dbflag & DB_CREAT) == 0);
+ bailout:
+ mdbx_free(namedup);
+ } else {
+ txn->mt_dbflags[slot] = (uint8_t)dbflag;
+ txn->mt_dbxs[slot].md_name.iov_base = namedup;
+ txn->mt_dbxs[slot].md_name.iov_len = len;
+ txn->mt_numdbs += (slot == txn->mt_numdbs);
+ if ((dbflag & DB_CREAT) == 0) {
+ env->me_dbflags[slot] = txn->mt_dbs[slot].md_flags | MDBX_VALID;
+ mdbx_compiler_barrier();
+ if (env->me_numdbs <= slot)
+ env->me_numdbs = slot + 1;
+ } else {
+ env->me_dbiseqs[slot] += 1;
+ }
+ txn->mt_dbiseqs[slot] = env->me_dbiseqs[slot];
+ *dbi = slot;
+ }
+
+ mdbx_ensure(env, mdbx_fastmutex_release(&env->me_dbi_lock) == MDBX_SUCCESS);
+ return rc;
+}
+
+int mdbx_dbi_open(MDBX_txn *txn, const char *table_name, unsigned table_flags,
+ MDBX_dbi *dbi) {
+ return mdbx_dbi_open_ex(txn, table_name, table_flags, dbi, nullptr, nullptr);
+}
+
+int __cold mdbx_dbi_stat(MDBX_txn *txn, MDBX_dbi dbi, MDBX_stat *dest,
+ size_t bytes) {
+ int rc = check_txn(txn, MDBX_TXN_BLOCKED);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ if (unlikely(!dest))
+ return MDBX_EINVAL;
+
+ if (unlikely(!TXN_DBI_EXIST(txn, dbi, DB_VALID)))
+ return MDBX_EINVAL;
+
+ const size_t size_before_modtxnid = offsetof(MDBX_stat, ms_mod_txnid);
+ if (unlikely(bytes != sizeof(MDBX_stat)) && bytes != size_before_modtxnid)
+ return MDBX_EINVAL;
+
+ if (unlikely(txn->mt_flags & MDBX_TXN_BLOCKED))
+ return MDBX_BAD_TXN;
+
+ if (unlikely(txn->mt_dbflags[dbi] & DB_STALE)) {
+ rc = mdbx_fetch_sdb(txn, dbi);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+ }
+ mdbx_stat0(txn->mt_env, &txn->mt_dbs[dbi], dest, bytes);
+ return MDBX_SUCCESS;
+}
+
+static int mdbx_dbi_close_locked(MDBX_env *env, MDBX_dbi dbi) {
+ if (unlikely(dbi < CORE_DBS || dbi >= env->me_maxdbs))
+ return MDBX_EINVAL;
+
+ char *ptr = env->me_dbxs[dbi].md_name.iov_base;
+ /* If there was no name, this was already closed */
+ if (unlikely(!ptr))
+ return MDBX_BAD_DBI;
+
+ env->me_dbflags[dbi] = 0;
+ env->me_dbxs[dbi].md_name.iov_len = 0;
+ mdbx_compiler_barrier();
+ env->me_dbiseqs[dbi]++;
+ env->me_dbxs[dbi].md_name.iov_base = NULL;
+ mdbx_free(ptr);
+ return MDBX_SUCCESS;
+}
+
+int mdbx_dbi_close(MDBX_env *env, MDBX_dbi dbi) {
+ if (unlikely(!env))
+ return MDBX_EINVAL;
+
+ if (unlikely(env->me_signature != MDBX_ME_SIGNATURE))
+ return MDBX_EBADSIGN;
+
+ if (unlikely(dbi < CORE_DBS || dbi >= env->me_maxdbs))
+ return MDBX_EINVAL;
+
+ int rc = mdbx_fastmutex_acquire(&env->me_dbi_lock);
+ if (likely(rc == MDBX_SUCCESS)) {
+ rc = mdbx_dbi_close_locked(env, dbi);
+ mdbx_ensure(env, mdbx_fastmutex_release(&env->me_dbi_lock) == MDBX_SUCCESS);
+ }
+ return rc;
+}
+
+int mdbx_dbi_flags_ex(MDBX_txn *txn, MDBX_dbi dbi, unsigned *flags,
+ unsigned *state) {
+ int rc = check_txn(txn, MDBX_TXN_BLOCKED);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ if (unlikely(!flags || !state))
+ return MDBX_EINVAL;
+
+ if (unlikely(!TXN_DBI_EXIST(txn, dbi, DB_VALID)))
+ return MDBX_EINVAL;
+
+ *flags = txn->mt_dbs[dbi].md_flags & PERSISTENT_FLAGS;
+ *state = txn->mt_dbflags[dbi] & (DB_FRESH | DB_CREAT | DB_DIRTY | DB_STALE);
+
+ return MDBX_SUCCESS;
+}
+
+int mdbx_dbi_flags(MDBX_txn *txn, MDBX_dbi dbi, unsigned *flags) {
+ unsigned state;
+ return mdbx_dbi_flags_ex(txn, dbi, flags, &state);
+}
+
+/* Add all the DB's pages to the free list.
+ * [in] mc Cursor on the DB to free.
+ * [in] subs non-Zero to check for sub-DBs in this DB.
+ * Returns 0 on success, non-zero on failure. */
+static int mdbx_drop0(MDBX_cursor *mc, int subs) {
+ int rc = mdbx_page_search(mc, NULL, MDBX_PS_FIRST);
+ if (likely(rc == MDBX_SUCCESS)) {
+ MDBX_txn *txn = mc->mc_txn;
+ MDBX_cursor mx;
+ unsigned i;
+
+ /* DUPSORT sub-DBs have no ovpages/DBs. Omit scanning leaves.
+ * This also avoids any P_LEAF2 pages, which have no nodes.
+ * Also if the DB doesn't have sub-DBs and has no overflow
+ * pages, omit scanning leaves. */
+ if ((mc->mc_flags & C_SUB) || (subs | mc->mc_db->md_overflow_pages) == 0)
+ mdbx_cursor_pop(mc);
+
+ rc = mdbx_pnl_need(&txn->tw.retired_pages,
+ mc->mc_db->md_branch_pages + mc->mc_db->md_leaf_pages +
+ mc->mc_db->md_overflow_pages);
+ if (unlikely(rc))
+ goto done;
+
+ mdbx_cursor_copy(mc, &mx);
+ while (mc->mc_snum > 0) {
+ MDBX_page *mp = mc->mc_pg[mc->mc_top];
+ unsigned n = page_numkeys(mp);
+ if (IS_LEAF(mp)) {
+ for (i = 0; i < n; i++) {
+ MDBX_node *node = page_node(mp, i);
+ if (node_flags(node) & F_BIGDATA) {
+ MDBX_page *omp;
+ rc = mdbx_page_get(mc, node_largedata_pgno(node), &omp, NULL);
+ if (unlikely(rc))
+ goto done;
+ mdbx_cassert(mc, IS_OVERFLOW(omp));
+ rc = mdbx_page_retire(mc, omp);
+ if (unlikely(rc))
+ goto done;
+ if (!mc->mc_db->md_overflow_pages && !subs)
+ break;
+ } else if (subs && (node_flags(node) & F_SUBDATA)) {
+ rc = mdbx_xcursor_init1(mc, node);
+ if (unlikely(rc != MDBX_SUCCESS))
+ goto done;
+ rc = mdbx_drop0(&mc->mc_xcursor->mx_cursor, 0);
+ if (unlikely(rc))
+ goto done;
+ }
+ }
+ if (!subs && !mc->mc_db->md_overflow_pages)
+ goto pop;
+ } else {
+ for (i = 0; i < n; i++) {
+ /* free it */
+ rc = mdbx_retire_pgno(mc, node_pgno(page_node(mp, i)));
+ if (unlikely(rc))
+ goto done;
+ }
+ }
+ if (!mc->mc_top)
+ break;
+ mdbx_cassert(mc, i <= UINT16_MAX);
+ mc->mc_ki[mc->mc_top] = (indx_t)i;
+ rc = mdbx_cursor_sibling(mc, 1);
+ if (rc) {
+ if (unlikely(rc != MDBX_NOTFOUND))
+ goto done;
+ /* no more siblings, go back to beginning
+ * of previous level. */
+ pop:
+ mdbx_cursor_pop(mc);
+ mc->mc_ki[0] = 0;
+ for (i = 1; i < mc->mc_snum; i++) {
+ mc->mc_ki[i] = 0;
+ mc->mc_pg[i] = mx.mc_pg[i];
+ }
+ }
+ }
+ /* free it */
+ rc = mdbx_retire_pgno(mc, mc->mc_db->md_root);
+ done:
+ if (unlikely(rc))
+ txn->mt_flags |= MDBX_TXN_ERROR;
+ } else if (rc == MDBX_NOTFOUND) {
+ rc = MDBX_SUCCESS;
+ }
+ mc->mc_flags &= ~C_INITIALIZED;
+ return rc;
+}
+
+int mdbx_drop(MDBX_txn *txn, MDBX_dbi dbi, int del) {
+ int rc = check_txn_rw(txn, MDBX_TXN_BLOCKED);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ if (unlikely(1 < (unsigned)del))
+ return MDBX_EINVAL;
+
+ if (unlikely(!TXN_DBI_EXIST(txn, dbi, DB_USRVALID)))
+ return MDBX_EINVAL;
+
+ if (unlikely(TXN_DBI_CHANGED(txn, dbi)))
+ return MDBX_BAD_DBI;
+
+ MDBX_cursor *mc;
+ rc = mdbx_cursor_open(txn, dbi, &mc);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ if (unlikely(!TXN_DBI_EXIST(txn, dbi, DB_USRVALID))) {
+ rc = MDBX_EINVAL;
+ goto bailout;
+ }
+
+ if (unlikely(TXN_DBI_CHANGED(txn, dbi))) {
+ rc = MDBX_BAD_DBI;
+ goto bailout;
+ }
+
+ rc = mdbx_drop0(mc, mc->mc_db->md_flags & MDBX_DUPSORT);
+ /* Invalidate the dropped DB's cursors */
+ for (MDBX_cursor *m2 = txn->mt_cursors[dbi]; m2; m2 = m2->mc_next)
+ m2->mc_flags &= ~(C_INITIALIZED | C_EOF);
+ if (unlikely(rc))
+ goto bailout;
+
+ /* Can't delete the main DB */
+ if (del && dbi >= CORE_DBS) {
+ rc = mdbx_del0(txn, MAIN_DBI, &mc->mc_dbx->md_name, NULL, F_SUBDATA);
+ if (likely(rc == MDBX_SUCCESS)) {
+ txn->mt_dbflags[dbi] = DB_STALE;
+ MDBX_env *env = txn->mt_env;
+ rc = mdbx_fastmutex_acquire(&env->me_dbi_lock);
+ if (unlikely(rc != MDBX_SUCCESS)) {
+ txn->mt_flags |= MDBX_TXN_ERROR;
+ goto bailout;
+ }
+ mdbx_dbi_close_locked(env, dbi);
+ mdbx_ensure(env,
+ mdbx_fastmutex_release(&env->me_dbi_lock) == MDBX_SUCCESS);
+ } else {
+ txn->mt_flags |= MDBX_TXN_ERROR;
+ }
+ } else {
+ /* reset the DB record, mark it dirty */
+ txn->mt_dbflags[dbi] |= DB_DIRTY;
+ txn->mt_dbs[dbi].md_depth = 0;
+ txn->mt_dbs[dbi].md_branch_pages = 0;
+ txn->mt_dbs[dbi].md_leaf_pages = 0;
+ txn->mt_dbs[dbi].md_overflow_pages = 0;
+ txn->mt_dbs[dbi].md_entries = 0;
+ txn->mt_dbs[dbi].md_root = P_INVALID;
+ txn->mt_dbs[dbi].md_seq = 0;
+ txn->mt_flags |= MDBX_TXN_DIRTY;
+ }
+
+bailout:
+ mdbx_cursor_close(mc);
+ return rc;
+}
+
+int mdbx_set_compare(MDBX_txn *txn, MDBX_dbi dbi, MDBX_cmp_func *cmp) {
+ int rc = check_txn(txn, MDBX_TXN_BLOCKED);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ if (unlikely(!TXN_DBI_EXIST(txn, dbi, DB_USRVALID)))
+ return MDBX_EINVAL;
+
+ txn->mt_dbxs[dbi].md_cmp = cmp;
+ return MDBX_SUCCESS;
+}
+
+int mdbx_set_dupsort(MDBX_txn *txn, MDBX_dbi dbi, MDBX_cmp_func *cmp) {
+ int rc = check_txn(txn, MDBX_TXN_BLOCKED);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ if (unlikely(!TXN_DBI_EXIST(txn, dbi, DB_USRVALID)))
+ return MDBX_EINVAL;
+
+ txn->mt_dbxs[dbi].md_dcmp = cmp;
+ return MDBX_SUCCESS;
+}
+
+int __cold mdbx_reader_list(MDBX_env *env, MDBX_reader_list_func *func,
+ void *ctx) {
+ if (unlikely(!env || !func))
+ return MDBX_EINVAL;
+
+ if (unlikely(env->me_signature != MDBX_ME_SIGNATURE))
+ return MDBX_EBADSIGN;
+
+ int rc = MDBX_RESULT_TRUE;
+ int serial = 0;
+ if (likely(env->me_lck)) {
+ const unsigned snap_nreaders = env->me_lck->mti_numreaders;
+ for (unsigned i = 0; i < snap_nreaders; i++) {
+ const MDBX_reader *r = env->me_lck->mti_readers + i;
+ retry_reader:;
+ const uint32_t pid = r->mr_pid;
+ if (!pid)
+ continue;
+ txnid_t txnid = safe64_read(&r->mr_txnid);
+ const size_t tid = r->mr_tid;
+ const pgno_t pages_used = r->mr_snapshot_pages_used;
+ const uint64_t reader_pages_retired = r->mr_snapshot_pages_retired;
+ mdbx_compiler_barrier();
+ if (unlikely(tid != r->mr_tid ||
+ pages_used != r->mr_snapshot_pages_used ||
+ reader_pages_retired != r->mr_snapshot_pages_retired ||
+ txnid != safe64_read(&r->mr_txnid) || pid != r->mr_pid))
+ goto retry_reader;
+
+ mdbx_assert(env, txnid > 0);
+ if (txnid >= SAFE64_INVALID_THRESHOLD)
+ txnid = 0;
+
+ size_t bytes_used = 0;
+ size_t bytes_retained = 0;
+ uint64_t lag = 0;
+ if (txnid) {
+ retry_header:;
+ const MDBX_meta *const recent_meta = mdbx_meta_head(env);
+ const uint64_t head_pages_retired = recent_meta->mm_pages_retired;
+ const txnid_t head_txnid = mdbx_meta_txnid_fluid(env, recent_meta);
+ mdbx_compiler_barrier();
+ if (unlikely(recent_meta != mdbx_meta_head(env) ||
+ head_pages_retired != recent_meta->mm_pages_retired) ||
+ head_txnid != mdbx_meta_txnid_fluid(env, recent_meta))
+ goto retry_header;
+
+ lag = (head_txnid - txnid) / MDBX_TXNID_STEP;
+ bytes_used = pgno2bytes(env, pages_used);
+ bytes_retained = (head_pages_retired > reader_pages_retired)
+ ? pgno2bytes(env, (pgno_t)(head_pages_retired -
+ reader_pages_retired))
+ : 0;
+ }
+ rc = func(ctx, ++serial, i, pid, (mdbx_tid_t)tid, txnid, lag, bytes_used,
+ bytes_retained);
+ if (unlikely(rc != MDBX_SUCCESS))
+ break;
+ }
+ }
+
+ return rc;
+}
+
+/* Insert pid into list if not already present.
+ * return -1 if already present. */
+static int __cold mdbx_pid_insert(uint32_t *ids, uint32_t pid) {
+ /* binary search of pid in list */
+ unsigned base = 0;
+ unsigned cursor = 1;
+ int val = 0;
+ unsigned n = ids[0];
+
+ while (n > 0) {
+ unsigned pivot = n >> 1;
+ cursor = base + pivot + 1;
+ val = pid - ids[cursor];
+
+ if (val < 0) {
+ n = pivot;
+ } else if (val > 0) {
+ base = cursor;
+ n -= pivot + 1;
+ } else {
+ /* found, so it's a duplicate */
+ return -1;
+ }
+ }
+
+ if (val > 0)
+ ++cursor;
+
+ ids[0]++;
+ for (n = ids[0]; n > cursor; n--)
+ ids[n] = ids[n - 1];
+ ids[n] = pid;
+ return 0;
+}
+
+int __cold mdbx_reader_check(MDBX_env *env, int *dead) {
+ if (unlikely(!env))
+ return MDBX_EINVAL;
+
+ if (unlikely(env->me_signature != MDBX_ME_SIGNATURE))
+ return MDBX_EBADSIGN;
+
+ if (dead)
+ *dead = 0;
+ return mdbx_reader_check0(env, false, dead);
+}
+
+/* Return:
+ * MDBX_RESULT_TRUE - done and mutex recovered
+ * MDBX_SUCCESS - done
+ * Otherwise errcode. */
+int __cold mdbx_reader_check0(MDBX_env *env, int rdt_locked, int *dead) {
+ mdbx_assert(env, rdt_locked >= 0);
+
+#if MDBX_TXN_CHECKPID
+ if (unlikely(env->me_pid != mdbx_getpid())) {
+ env->me_flags |= MDBX_FATAL_ERROR;
+ return MDBX_PANIC;
+ }
+#endif /* MDBX_TXN_CHECKPID */
+
+ MDBX_lockinfo *const lck = env->me_lck;
+ if (unlikely(lck == NULL)) {
+ /* exclusive mode */
+ if (dead)
+ *dead = 0;
+ return MDBX_SUCCESS;
+ }
+
+ lck->mti_reader_check_timestamp = mdbx_osal_monotime();
+ const unsigned snap_nreaders = lck->mti_numreaders;
+ uint32_t pidsbuf_onstask[142];
+ uint32_t *const pids =
+ (snap_nreaders < ARRAY_LENGTH(pidsbuf_onstask))
+ ? pidsbuf_onstask
+ : mdbx_malloc((snap_nreaders + 1) * sizeof(uint32_t));
+ if (unlikely(!pids))
+ return MDBX_ENOMEM;
+
+ pids[0] = 0;
+
+ int rc = MDBX_SUCCESS, count = 0;
+ for (unsigned i = 0; i < snap_nreaders; i++) {
+ const uint32_t pid = lck->mti_readers[i].mr_pid;
+ if (pid == 0)
+ continue /* skip empty */;
+ if (pid == env->me_pid)
+ continue /* skip self */;
+ if (mdbx_pid_insert(pids, pid) != 0)
+ continue /* such pid already processed */;
+
+ int err = mdbx_rpid_check(env, pid);
+ if (err == MDBX_RESULT_TRUE)
+ continue /* reader is live */;
+
+ if (err != MDBX_SUCCESS) {
+ rc = err;
+ break /* mdbx_rpid_check() failed */;
+ }
+
+ /* stale reader found */
+ if (!rdt_locked) {
+ err = mdbx_rdt_lock(env);
+ if (MDBX_IS_ERROR(err)) {
+ rc = err;
+ break;
+ }
+
+ rdt_locked = -1;
+ if (err == MDBX_RESULT_TRUE) {
+ /* mutex recovered, the mdbx_mutex_failed() checked all readers */
+ rc = MDBX_RESULT_TRUE;
+ break;
+ }
+
+ /* a other process may have clean and reused slot, recheck */
+ if (lck->mti_readers[i].mr_pid != pid)
+ continue;
+
+ err = mdbx_rpid_check(env, pid);
+ if (MDBX_IS_ERROR(err)) {
+ rc = err;
+ break;
+ }
+
+ if (err != MDBX_SUCCESS)
+ continue /* the race with other process, slot reused */;
+ }
+
+ /* clean it */
+ for (unsigned j = i; j < snap_nreaders; j++) {
+ if (lck->mti_readers[j].mr_pid == pid) {
+ mdbx_debug("clear stale reader pid %" PRIuPTR " txn %" PRIaTXN,
+ (size_t)pid, lck->mti_readers[j].mr_txnid.inconsistent);
+ lck->mti_readers[j].mr_pid = 0;
+ lck->mti_readers_refresh_flag = true;
+ count++;
+ }
+ }
+ }
+
+ if (rdt_locked < 0)
+ mdbx_rdt_unlock(env);
+
+ if (pids != pidsbuf_onstask)
+ mdbx_free(pids);
+
+ if (dead)
+ *dead = count;
+ return rc;
+}
+
+int __cold mdbx_setup_debug(int loglevel, int flags, MDBX_debug_func *logger) {
+ const int rc = mdbx_runtime_flags | (mdbx_loglevel << 16);
+
+#if !MDBX_DEBUG
+ (void)loglevel;
+#else
+ if (loglevel != -1)
+ mdbx_loglevel = (uint8_t)loglevel;
+#endif
+
+ if (flags != -1) {
+#if !MDBX_DEBUG
+ flags &= MDBX_DBG_DUMP | MDBX_DBG_LEGACY_MULTIOPEN;
+#else
+ flags &= MDBX_DBG_ASSERT | MDBX_DBG_AUDIT | MDBX_DBG_JITTER |
+ MDBX_DBG_DUMP | MDBX_DBG_LEGACY_MULTIOPEN;
+#endif
+#if defined(__linux__) || defined(__gnu_linux__)
+ if ((mdbx_runtime_flags ^ flags) & MDBX_DBG_DUMP) {
+ /* http://man7.org/linux/man-pages/man5/core.5.html */
+ const unsigned long dump_bits =
+ 1 << 3 /* Dump file-backed shared mappings */
+ | 1 << 6 /* Dump shared huge pages */
+ | 1 << 8 /* Dump shared DAX pages */;
+ const int core_filter_fd =
+ open("/proc/self/coredump_filter", O_TRUNC | O_RDWR);
+ if (core_filter_fd != -1) {
+ char buf[32];
+ intptr_t bytes = pread(core_filter_fd, buf, sizeof(buf), 0);
+ if (bytes > 0 && (size_t)bytes < sizeof(buf)) {
+ buf[bytes] = 0;
+ const unsigned long present_mask = strtoul(buf, NULL, 16);
+ const unsigned long wanna_mask = (flags & MDBX_DBG_DUMP)
+ ? present_mask | dump_bits
+ : present_mask & ~dump_bits;
+ if (wanna_mask != present_mask) {
+ bytes = snprintf(buf, sizeof(buf), "0x%lx\n", wanna_mask);
+ if (bytes > 0 && (size_t)bytes < sizeof(buf)) {
+ bytes = pwrite(core_filter_fd, buf, bytes, 0);
+ (void)bytes;
+ }
+ }
+ }
+ close(core_filter_fd);
+ }
+ }
+#endif /* Linux */
+ mdbx_runtime_flags = (uint8_t)flags;
+ }
+
+ if (-1 != (intptr_t)logger)
+ mdbx_debug_logger = logger;
+ return rc;
+}
+
+static txnid_t __cold mdbx_oomkick(MDBX_env *env, const txnid_t laggard) {
+ mdbx_debug("%s", "DB size maxed out");
+
+ int retry;
+ for (retry = 0; retry < INT_MAX; ++retry) {
+ txnid_t oldest = mdbx_reclaiming_detent(env);
+ mdbx_assert(env, oldest < env->me_txn0->mt_txnid);
+ mdbx_assert(env, oldest >= laggard);
+ mdbx_assert(env, oldest >= *env->me_oldest);
+ if (oldest == laggard || unlikely(env->me_lck == NULL /* exclusive mode */))
+ return oldest;
+
+ if (MDBX_IS_ERROR(mdbx_reader_check0(env, false, NULL)))
+ break;
+
+ MDBX_reader *asleep = nullptr;
+ MDBX_lockinfo *const lck = env->me_lck;
+ uint64_t oldest_retired = UINT64_MAX;
+ const unsigned snap_nreaders = lck->mti_numreaders;
+ for (unsigned i = 0; i < snap_nreaders; ++i) {
+ retry:
+ if (lck->mti_readers[i].mr_pid) {
+ /* mdbx_jitter4testing(true); */
+ const uint64_t snap_retired =
+ lck->mti_readers[i].mr_snapshot_pages_retired;
+ const txnid_t snap_txnid = safe64_read(&lck->mti_readers[i].mr_txnid);
+ mdbx_memory_barrier();
+ if (unlikely(snap_retired !=
+ lck->mti_readers[i].mr_snapshot_pages_retired ||
+ snap_txnid != safe64_read(&lck->mti_readers[i].mr_txnid)))
+ goto retry;
+ if (oldest > snap_txnid &&
+ laggard <= /* ignore pending updates */ snap_txnid) {
+ oldest = snap_txnid;
+ oldest_retired = snap_retired;
+ asleep = &lck->mti_readers[i];
+ }
+ }
+ }
+
+ if (laggard < oldest || !asleep) {
+ if (retry && env->me_oom_func) {
+ /* LY: notify end of oom-loop */
+ const txnid_t gap = oldest - laggard;
+ env->me_oom_func(env, 0, 0, laggard,
+ (gap < UINT_MAX) ? (unsigned)gap : UINT_MAX, 0,
+ -retry);
+ }
+ mdbx_notice("oom-kick: update oldest %" PRIaTXN " -> %" PRIaTXN,
+ *env->me_oldest, oldest);
+ mdbx_assert(env, *env->me_oldest <= oldest);
+ return *env->me_oldest = oldest;
+ }
+
+ if (!env->me_oom_func)
+ break;
+
+ uint32_t pid = asleep->mr_pid;
+ size_t tid = asleep->mr_tid;
+ if (safe64_read(&asleep->mr_txnid) != laggard || pid <= 0)
+ continue;
+
+ const MDBX_meta *head_meta = mdbx_meta_head(env);
+ const txnid_t gap =
+ (mdbx_meta_txnid_stable(env, head_meta) - laggard) / MDBX_TXNID_STEP;
+ const uint64_t head_retired = head_meta->mm_pages_retired;
+ const size_t space =
+ (oldest_retired > head_retired)
+ ? pgno2bytes(env, (pgno_t)(oldest_retired - head_retired))
+ : 0;
+ int rc = env->me_oom_func(env, pid, (mdbx_tid_t)tid, laggard,
+ (gap < UINT_MAX) ? (unsigned)gap : UINT_MAX,
+ space, retry);
+ if (rc < 0)
+ break;
+
+ if (rc > 0) {
+ if (rc == 1) {
+ safe64_reset_compare(&asleep->mr_txnid, laggard);
+ } else {
+ safe64_reset(&asleep->mr_txnid, true);
+ asleep->mr_tid = 0;
+ asleep->mr_pid = 0;
+ }
+ lck->mti_readers_refresh_flag = true;
+ mdbx_flush_noncoherent_cpu_writeback();
+ }
+ }
+
+ if (retry && env->me_oom_func) {
+ /* LY: notify end of oom-loop */
+ env->me_oom_func(env, 0, 0, laggard, 0, 0, -retry);
+ }
+ return mdbx_find_oldest(env->me_txn);
+}
+
+int __cold mdbx_env_set_syncbytes(MDBX_env *env, size_t threshold) {
+ if (unlikely(!env))
+ return MDBX_EINVAL;
+
+ if (unlikely(env->me_signature != MDBX_ME_SIGNATURE))
+ return MDBX_EBADSIGN;
+
+ if (unlikely(env->me_flags & (MDBX_RDONLY | MDBX_FATAL_ERROR)))
+ return MDBX_EACCESS;
+
+ if (unlikely(!env->me_map))
+ return MDBX_EPERM;
+
+ *env->me_autosync_threshold = bytes2pgno(env, threshold + env->me_psize - 1);
+ if (threshold) {
+ int err = mdbx_env_sync_poll(env);
+ if (unlikely(MDBX_IS_ERROR(err)))
+ return err;
+ }
+ return MDBX_SUCCESS;
+}
+
+int __cold mdbx_env_set_syncperiod(MDBX_env *env, unsigned seconds_16dot16) {
+ if (unlikely(!env))
+ return MDBX_EINVAL;
+
+ if (unlikely(env->me_signature != MDBX_ME_SIGNATURE))
+ return MDBX_EBADSIGN;
+
+ if (unlikely(env->me_flags & (MDBX_RDONLY | MDBX_FATAL_ERROR)))
+ return MDBX_EACCESS;
+
+ if (unlikely(!env->me_map))
+ return MDBX_EPERM;
+
+ *env->me_autosync_period = mdbx_osal_16dot16_to_monotime(seconds_16dot16);
+ if (seconds_16dot16) {
+ int err = mdbx_env_sync_poll(env);
+ if (unlikely(MDBX_IS_ERROR(err)))
+ return err;
+ }
+ return MDBX_SUCCESS;
+}
+
+int __cold mdbx_env_set_oomfunc(MDBX_env *env, MDBX_oom_func *oomfunc) {
+ if (unlikely(!env))
+ return MDBX_EINVAL;
+
+ if (unlikely(env->me_signature != MDBX_ME_SIGNATURE))
+ return MDBX_EBADSIGN;
+
+ env->me_oom_func = oomfunc;
+ return MDBX_SUCCESS;
+}
+
+MDBX_oom_func *__cold mdbx_env_get_oomfunc(MDBX_env *env) {
+ return likely(env && env->me_signature == MDBX_ME_SIGNATURE)
+ ? env->me_oom_func
+ : NULL;
+}
+
+#ifdef __SANITIZE_THREAD__
+/* LY: avoid tsan-trap by me_txn, mm_last_pg and mt_next_pgno */
+__attribute__((__no_sanitize_thread__, __noinline__))
+#endif
+int mdbx_txn_straggler(MDBX_txn *txn, int *percent)
+{
+ int rc = check_txn(txn, MDBX_TXN_BLOCKED);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return (rc > 0) ? -rc : rc;
+
+ MDBX_env *env = txn->mt_env;
+ if (unlikely((txn->mt_flags & MDBX_RDONLY) == 0)) {
+ if (percent)
+ *percent =
+ (int)((txn->mt_next_pgno * UINT64_C(100) + txn->mt_end_pgno / 2) /
+ txn->mt_end_pgno);
+ return 0;
+ }
+
+ txnid_t recent;
+ MDBX_meta *meta;
+ do {
+ meta = mdbx_meta_head(env);
+ recent = mdbx_meta_txnid_fluid(env, meta);
+ if (percent) {
+ const pgno_t maxpg = meta->mm_geo.now;
+ *percent = (int)((meta->mm_geo.next * UINT64_C(100) + maxpg / 2) / maxpg);
+ }
+ } while (unlikely(recent != mdbx_meta_txnid_fluid(env, meta)));
+
+ txnid_t lag = (recent - txn->mt_txnid) / MDBX_TXNID_STEP;
+ return (lag > INT_MAX) ? INT_MAX : (int)lag;
+}
+
+typedef struct mdbx_walk_ctx {
+ void *mw_user;
+ MDBX_pgvisitor_func *mw_visitor;
+ MDBX_cursor mw_cursor;
+} mdbx_walk_ctx_t;
+
+/* Depth-first tree traversal. */
+static int __cold mdbx_env_walk(mdbx_walk_ctx_t *ctx, const char *dbi,
+ pgno_t pgno, int deep) {
+ if (unlikely(pgno == P_INVALID))
+ return MDBX_SUCCESS; /* empty db */
+
+ MDBX_page *mp;
+ int rc = mdbx_page_get(&ctx->mw_cursor, pgno, &mp, NULL);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ rc = mdbx_page_check(ctx->mw_cursor.mc_txn->mt_env, mp, false);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ const int nkeys = page_numkeys(mp);
+ size_t header_size = IS_LEAF2(mp) ? PAGEHDRSZ : PAGEHDRSZ + mp->mp_lower;
+ size_t unused_size = page_room(mp);
+ size_t payload_size = 0;
+ size_t align_bytes = 0;
+ MDBX_page_type_t type;
+
+ /* LY: Don't use mask here, e.g bitwise
+ * (P_BRANCH|P_LEAF|P_LEAF2|P_META|P_OVERFLOW|P_SUBP).
+ * Pages should not me marked dirty/loose or otherwise. */
+ switch (mp->mp_flags) {
+ case P_BRANCH:
+ type = MDBX_page_branch;
+ if (unlikely(nkeys < 2))
+ return MDBX_CORRUPTED;
+ break;
+ case P_LEAF:
+ type = MDBX_page_leaf;
+ break;
+ case P_LEAF | P_LEAF2:
+ type = MDBX_page_dupfixed_leaf;
+ break;
+ default:
+ return MDBX_CORRUPTED;
+ }
+
+ for (int i = 0; i < nkeys;
+ align_bytes += ((payload_size + align_bytes) & 1), i++) {
+ if (type == MDBX_page_dupfixed_leaf) {
+ /* LEAF2 pages have no mp_ptrs[] or node headers */
+ payload_size += mp->mp_leaf2_ksize;
+ continue;
+ }
+
+ MDBX_node *node = page_node(mp, i);
+ payload_size += NODESIZE + node_ks(node);
+
+ if (type == MDBX_page_branch) {
+ assert(i > 0 || node_ks(node) == 0);
+ continue;
+ }
+
+ assert(type == MDBX_page_leaf);
+ switch (node_flags(node)) {
+ case 0 /* usual node */: {
+ payload_size += node_ds(node);
+ } break;
+
+ case F_BIGDATA /* long data on the large/overflow page */: {
+ payload_size += sizeof(pgno_t);
+
+ const pgno_t large_pgno = node_largedata_pgno(node);
+ MDBX_page *op;
+ rc = mdbx_page_get(&ctx->mw_cursor, large_pgno, &op, NULL);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+ rc = mdbx_page_check(ctx->mw_cursor.mc_txn->mt_env, op, false);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ /* LY: Don't use mask here, e.g bitwise
+ * (P_BRANCH|P_LEAF|P_LEAF2|P_META|P_OVERFLOW|P_SUBP).
+ * Pages should not me marked dirty/loose or otherwise. */
+ if (unlikely(P_OVERFLOW != op->mp_flags))
+ return MDBX_CORRUPTED;
+
+ const size_t over_header = PAGEHDRSZ;
+ const size_t over_payload = node_ds(node);
+ const size_t over_unused =
+ pgno2bytes(ctx->mw_cursor.mc_txn->mt_env, op->mp_pages) -
+ over_payload - over_header;
+
+ rc = ctx->mw_visitor(
+ large_pgno, op->mp_pages, ctx->mw_user, deep, dbi,
+ pgno2bytes(ctx->mw_cursor.mc_txn->mt_env, op->mp_pages),
+ MDBX_page_large, 1, over_payload, over_header, over_unused);
+ } break;
+
+ case F_SUBDATA /* sub-db */: {
+ const size_t namelen = node_ks(node);
+ if (unlikely(namelen == 0 || node_ds(node) < sizeof(MDBX_db)))
+ return MDBX_CORRUPTED;
+ payload_size += node_ds(node);
+ } break;
+
+ case F_SUBDATA | F_DUPDATA /* dupsorted sub-tree */: {
+ if (unlikely(node_ds(node) != sizeof(MDBX_db)))
+ return MDBX_CORRUPTED;
+ payload_size += sizeof(MDBX_db);
+ } break;
+
+ case F_DUPDATA /* short sub-page */: {
+ if (unlikely(node_ds(node) <= PAGEHDRSZ))
+ return MDBX_CORRUPTED;
+
+ MDBX_page *sp = node_data(node);
+ const int nsubkeys = page_numkeys(sp);
+ size_t subheader_size =
+ IS_LEAF2(sp) ? PAGEHDRSZ : PAGEHDRSZ + sp->mp_lower;
+ size_t subunused_size = page_room(sp);
+ size_t subpayload_size = 0;
+ size_t subalign_bytes = 0;
+ MDBX_page_type_t subtype;
+
+ switch (sp->mp_flags & ~P_DIRTY /* ignore for sub-pages */) {
+ case P_LEAF | P_SUBP:
+ subtype = MDBX_subpage_leaf;
+ break;
+ case P_LEAF | P_LEAF2 | P_SUBP:
+ subtype = MDBX_subpage_dupfixed_leaf;
+ break;
+ default:
+ return MDBX_CORRUPTED;
+ }
+
+ for (int j = 0; j < nsubkeys;
+ subalign_bytes += ((subpayload_size + subalign_bytes) & 1), j++) {
+
+ if (subtype == MDBX_subpage_dupfixed_leaf) {
+ /* LEAF2 pages have no mp_ptrs[] or node headers */
+ subpayload_size += sp->mp_leaf2_ksize;
+ } else {
+ assert(subtype == MDBX_subpage_leaf);
+ MDBX_node *subnode = page_node(sp, j);
+ subpayload_size += NODESIZE + node_ks(subnode) + node_ds(subnode);
+ if (unlikely(node_flags(subnode) != 0))
+ return MDBX_CORRUPTED;
+ }
+ }
+
+ rc = ctx->mw_visitor(pgno, 0, ctx->mw_user, deep + 1, dbi, node_ds(node),
+ subtype, nsubkeys, subpayload_size, subheader_size,
+ subunused_size + subalign_bytes);
+ header_size += subheader_size;
+ unused_size += subunused_size;
+ payload_size += subpayload_size;
+ align_bytes += subalign_bytes;
+ } break;
+
+ default:
+ return MDBX_CORRUPTED;
+ }
+
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+ }
+
+ rc = ctx->mw_visitor(mp->mp_pgno, 1, ctx->mw_user, deep, dbi,
+ ctx->mw_cursor.mc_txn->mt_env->me_psize, type, nkeys,
+ payload_size, header_size, unused_size + align_bytes);
+
+ if (unlikely(rc != MDBX_SUCCESS))
+ return (rc == MDBX_RESULT_TRUE) ? MDBX_SUCCESS : rc;
+
+ for (int i = 0; i < nkeys; i++) {
+ if (type == MDBX_page_dupfixed_leaf)
+ continue;
+
+ MDBX_node *node = page_node(mp, i);
+ if (type == MDBX_page_branch) {
+ rc = mdbx_env_walk(ctx, dbi, node_pgno(node), deep + 1);
+ if (unlikely(rc != MDBX_SUCCESS)) {
+ if (rc != MDBX_RESULT_TRUE)
+ return rc;
+ break;
+ }
+ continue;
+ }
+
+ assert(type == MDBX_page_leaf);
+ MDBX_db db;
+ switch (node_flags(node)) {
+ default:
+ continue;
+
+ case F_SUBDATA /* sub-db */: {
+ const size_t namelen = node_ks(node);
+ if (unlikely(namelen == 0 || node_ds(node) != sizeof(MDBX_db)))
+ return MDBX_CORRUPTED;
+
+ char namebuf_onstask[142];
+ char *const name = (namelen < sizeof(namebuf_onstask))
+ ? namebuf_onstask
+ : mdbx_malloc(namelen + 1);
+ if (name) {
+ memcpy(name, node_key(node), namelen);
+ name[namelen] = 0;
+ memcpy(&db, node_data(node), sizeof(db));
+ rc = mdbx_env_walk(ctx, name, db.md_root, deep + 1);
+ if (name != namebuf_onstask)
+ mdbx_free(name);
+ } else {
+ rc = MDBX_ENOMEM;
+ }
+ } break;
+
+ case F_SUBDATA | F_DUPDATA /* dupsorted sub-tree */:
+ if (unlikely(node_ds(node) != sizeof(MDBX_db)))
+ return MDBX_CORRUPTED;
+
+ memcpy(&db, node_data(node), sizeof(db));
+ rc = mdbx_env_walk(ctx, dbi, db.md_root, deep + 1);
+ break;
+ }
+
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+ }
+
+ return MDBX_SUCCESS;
+}
+
+int __cold mdbx_env_pgwalk(MDBX_txn *txn, MDBX_pgvisitor_func *visitor,
+ void *user) {
+ int rc = check_txn(txn, MDBX_TXN_BLOCKED);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ mdbx_walk_ctx_t ctx;
+ memset(&ctx, 0, sizeof(ctx));
+ ctx.mw_cursor.mc_snum = 1;
+ ctx.mw_cursor.mc_txn = txn;
+ ctx.mw_user = user;
+ ctx.mw_visitor = visitor;
+
+ rc = visitor(0, NUM_METAS, user, 0, MDBX_PGWALK_META,
+ pgno2bytes(txn->mt_env, NUM_METAS), MDBX_page_meta, NUM_METAS,
+ sizeof(MDBX_meta) * NUM_METAS, PAGEHDRSZ * NUM_METAS,
+ (txn->mt_env->me_psize - sizeof(MDBX_meta) - PAGEHDRSZ) *
+ NUM_METAS);
+ if (!MDBX_IS_ERROR(rc))
+ rc = mdbx_env_walk(&ctx, MDBX_PGWALK_GC, txn->mt_dbs[FREE_DBI].md_root, 0);
+ if (!MDBX_IS_ERROR(rc))
+ rc =
+ mdbx_env_walk(&ctx, MDBX_PGWALK_MAIN, txn->mt_dbs[MAIN_DBI].md_root, 0);
+ if (!MDBX_IS_ERROR(rc))
+ rc = visitor(P_INVALID, 0, user, INT_MIN, NULL, 0, MDBX_page_void, 0, 0, 0,
+ 0);
+ return rc;
+}
+
+int mdbx_canary_put(MDBX_txn *txn, const mdbx_canary *canary) {
+ int rc = check_txn_rw(txn, MDBX_TXN_BLOCKED);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ if (likely(canary)) {
+ if (txn->mt_canary.x == canary->x && txn->mt_canary.y == canary->y &&
+ txn->mt_canary.z == canary->z)
+ return MDBX_SUCCESS;
+ txn->mt_canary.x = canary->x;
+ txn->mt_canary.y = canary->y;
+ txn->mt_canary.z = canary->z;
+ }
+ txn->mt_canary.v = txn->mt_txnid;
+
+ if ((txn->mt_flags & MDBX_TXN_DIRTY) == 0) {
+ txn->mt_flags |= MDBX_TXN_DIRTY;
+ *txn->mt_env->me_unsynced_pages += 1;
+ }
+ return MDBX_SUCCESS;
+}
+
+int mdbx_canary_get(MDBX_txn *txn, mdbx_canary *canary) {
+ int rc = check_txn(txn, MDBX_TXN_BLOCKED);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ if (unlikely(canary == NULL))
+ return MDBX_EINVAL;
+
+ *canary = txn->mt_canary;
+ return MDBX_SUCCESS;
+}
+
+int mdbx_cursor_on_first(MDBX_cursor *mc) {
+ if (unlikely(mc == NULL))
+ return MDBX_EINVAL;
+
+ if (unlikely(mc->mc_signature != MDBX_MC_SIGNATURE))
+ return MDBX_EBADSIGN;
+
+ if (!(mc->mc_flags & C_INITIALIZED))
+ return MDBX_RESULT_FALSE;
+
+ for (unsigned i = 0; i < mc->mc_snum; ++i) {
+ if (mc->mc_ki[i])
+ return MDBX_RESULT_FALSE;
+ }
+
+ return MDBX_RESULT_TRUE;
+}
+
+int mdbx_cursor_on_last(MDBX_cursor *mc) {
+ if (unlikely(mc == NULL))
+ return MDBX_EINVAL;
+
+ if (unlikely(mc->mc_signature != MDBX_MC_SIGNATURE))
+ return MDBX_EBADSIGN;
+
+ if (!(mc->mc_flags & C_INITIALIZED))
+ return MDBX_RESULT_FALSE;
+
+ for (unsigned i = 0; i < mc->mc_snum; ++i) {
+ unsigned nkeys = page_numkeys(mc->mc_pg[i]);
+ if (mc->mc_ki[i] < nkeys - 1)
+ return MDBX_RESULT_FALSE;
+ }
+
+ return MDBX_RESULT_TRUE;
+}
+
+int mdbx_cursor_eof(MDBX_cursor *mc) {
+ if (unlikely(mc == NULL))
+ return MDBX_EINVAL;
+
+ if (unlikely(mc->mc_signature != MDBX_MC_SIGNATURE))
+ return MDBX_EBADSIGN;
+
+ if ((mc->mc_flags & C_INITIALIZED) == 0)
+ return MDBX_RESULT_TRUE;
+
+ if (mc->mc_snum == 0)
+ return MDBX_RESULT_TRUE;
+
+ if ((mc->mc_flags & C_EOF) &&
+ mc->mc_ki[mc->mc_top] >= page_numkeys(mc->mc_pg[mc->mc_top]))
+ return MDBX_RESULT_TRUE;
+
+ return MDBX_RESULT_FALSE;
+}
+
+//------------------------------------------------------------------------------
+
+struct diff_result {
+ ptrdiff_t diff;
+ int level;
+ int root_nkeys;
+};
+
+/* calculates: r = x - y */
+__hot static int cursor_diff(const MDBX_cursor *const __restrict x,
+ const MDBX_cursor *const __restrict y,
+ struct diff_result *const __restrict r) {
+ r->diff = 0;
+ r->level = 0;
+ r->root_nkeys = 0;
+
+ if (unlikely(y->mc_signature != MDBX_MC_SIGNATURE ||
+ x->mc_signature != MDBX_MC_SIGNATURE))
+ return MDBX_EBADSIGN;
+
+ int rc = check_txn(x->mc_txn, MDBX_TXN_BLOCKED);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ if (unlikely(x->mc_txn != y->mc_txn))
+ return MDBX_BAD_TXN;
+
+ if (unlikely(y->mc_dbi != x->mc_dbi))
+ return MDBX_EINVAL;
+
+ if (unlikely(!(y->mc_flags & x->mc_flags & C_INITIALIZED)))
+ return MDBX_ENODATA;
+
+ while (likely(r->level < y->mc_snum && r->level < x->mc_snum)) {
+ if (unlikely(y->mc_pg[r->level] != x->mc_pg[r->level]))
+ return MDBX_PROBLEM;
+
+ int nkeys = page_numkeys(y->mc_pg[r->level]);
+ assert(nkeys > 0);
+ if (r->level == 0)
+ r->root_nkeys = nkeys;
+
+ const int limit_ki = nkeys - 1;
+ const int x_ki = x->mc_ki[r->level];
+ const int y_ki = y->mc_ki[r->level];
+ r->diff = ((x_ki < limit_ki) ? x_ki : limit_ki) -
+ ((y_ki < limit_ki) ? y_ki : limit_ki);
+ if (r->diff == 0) {
+ r->level += 1;
+ continue;
+ }
+
+ while (unlikely(r->diff == 1) &&
+ likely(r->level + 1 < y->mc_snum && r->level + 1 < x->mc_snum)) {
+ r->level += 1;
+ /* DB'PAGEs: 0------------------>MAX
+ *
+ * CURSORs: y < x
+ * STACK[i ]: |
+ * STACK[+1]: ...y++N|0++x...
+ */
+ nkeys = page_numkeys(y->mc_pg[r->level]);
+ r->diff = (nkeys - y->mc_ki[r->level]) + x->mc_ki[r->level];
+ assert(r->diff > 0);
+ }
+
+ while (unlikely(r->diff == -1) &&
+ likely(r->level + 1 < y->mc_snum && r->level + 1 < x->mc_snum)) {
+ r->level += 1;
+ /* DB'PAGEs: 0------------------>MAX
+ *
+ * CURSORs: x < y
+ * STACK[i ]: |
+ * STACK[+1]: ...x--N|0--y...
+ */
+ nkeys = page_numkeys(x->mc_pg[r->level]);
+ r->diff = -(nkeys - x->mc_ki[r->level]) - y->mc_ki[r->level];
+ assert(r->diff < 0);
+ }
+
+ return MDBX_SUCCESS;
+ }
+
+ r->diff = CMP2INT(x->mc_flags & C_EOF, y->mc_flags & C_EOF);
+ return MDBX_SUCCESS;
+}
+
+__hot static ptrdiff_t estimate(const MDBX_db *db,
+ struct diff_result *const __restrict dr) {
+ /* root: branch-page => scale = leaf-factor * branch-factor^(N-1)
+ * level-1: branch-page(s) => scale = leaf-factor * branch-factor^2
+ * level-2: branch-page(s) => scale = leaf-factor * branch-factor
+ * level-N: branch-page(s) => scale = leaf-factor
+ * leaf-level: leaf-page(s) => scale = 1
+ */
+ ptrdiff_t btree_power = db->md_depth - 2 - dr->level;
+ if (btree_power < 0)
+ return dr->diff;
+
+ ptrdiff_t estimated =
+ (ptrdiff_t)db->md_entries * dr->diff / (ptrdiff_t)db->md_leaf_pages;
+ if (btree_power == 0)
+ return estimated;
+
+ if (db->md_depth < 4) {
+ assert(dr->level == 0 && btree_power == 1);
+ return (ptrdiff_t)db->md_entries * dr->diff / (ptrdiff_t)dr->root_nkeys;
+ }
+
+ /* average_branchpage_fillfactor = total(branch_entries) / branch_pages
+ total(branch_entries) = leaf_pages + branch_pages - 1 (root page) */
+ const size_t log2_fixedpoint = sizeof(size_t) - 1;
+ const size_t half = UINT64_C(1) << (log2_fixedpoint - 1);
+ const size_t factor =
+ ((db->md_leaf_pages + db->md_branch_pages - 1) << log2_fixedpoint) /
+ db->md_branch_pages;
+ while (1) {
+ switch ((size_t)btree_power) {
+ default: {
+ const size_t square = (factor * factor + half) >> log2_fixedpoint;
+ const size_t quad = (square * square + half) >> log2_fixedpoint;
+ do {
+ estimated = estimated * quad + half;
+ estimated >>= log2_fixedpoint;
+ btree_power -= 4;
+ } while (btree_power >= 4);
+ continue;
+ }
+ case 3:
+ estimated = estimated * factor + half;
+ estimated >>= log2_fixedpoint;
+ __fallthrough /* fall through */;
+ case 2:
+ estimated = estimated * factor + half;
+ estimated >>= log2_fixedpoint;
+ __fallthrough /* fall through */;
+ case 1:
+ estimated = estimated * factor + half;
+ estimated >>= log2_fixedpoint;
+ __fallthrough /* fall through */;
+ case 0:
+ if (unlikely(estimated > (ptrdiff_t)db->md_entries))
+ return (ptrdiff_t)db->md_entries;
+ if (unlikely(estimated < -(ptrdiff_t)db->md_entries))
+ return -(ptrdiff_t)db->md_entries;
+ return estimated;
+ }
+ }
+}
+
+__hot int mdbx_estimate_distance(const MDBX_cursor *first,
+ const MDBX_cursor *last,
+ ptrdiff_t *distance_items) {
+ if (unlikely(first == NULL || last == NULL || distance_items == NULL))
+ return MDBX_EINVAL;
+
+ *distance_items = 0;
+ struct diff_result dr;
+ int rc = cursor_diff(last, first, &dr);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ if (unlikely(dr.diff == 0) &&
+ F_ISSET(first->mc_db->md_flags & first->mc_db->md_flags,
+ MDBX_DUPSORT | C_INITIALIZED)) {
+ first = &first->mc_xcursor->mx_cursor;
+ last = &last->mc_xcursor->mx_cursor;
+ rc = cursor_diff(first, last, &dr);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+ }
+
+ if (likely(dr.diff != 0))
+ *distance_items = estimate(first->mc_db, &dr);
+
+ return MDBX_SUCCESS;
+}
+
+int mdbx_estimate_move(const MDBX_cursor *cursor, MDBX_val *key, MDBX_val *data,
+ MDBX_cursor_op move_op, ptrdiff_t *distance_items) {
+ if (unlikely(cursor == NULL || distance_items == NULL ||
+ move_op == MDBX_GET_CURRENT || move_op == MDBX_GET_MULTIPLE))
+ return MDBX_EINVAL;
+
+ if (unlikely(cursor->mc_signature != MDBX_MC_SIGNATURE))
+ return MDBX_EBADSIGN;
+
+ int rc = check_txn(cursor->mc_txn, MDBX_TXN_BLOCKED);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ if (!(cursor->mc_flags & C_INITIALIZED))
+ return MDBX_ENODATA;
+
+ MDBX_cursor_couple next;
+ mdbx_cursor_copy(cursor, &next.outer);
+ next.outer.mc_xcursor = NULL;
+ if (cursor->mc_db->md_flags & MDBX_DUPSORT) {
+ next.outer.mc_xcursor = &next.inner;
+ rc = mdbx_xcursor_init0(&next.outer);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+ MDBX_xcursor *mx = &container_of(cursor, MDBX_cursor_couple, outer)->inner;
+ mdbx_cursor_copy(&mx->mx_cursor, &next.inner.mx_cursor);
+ }
+
+ MDBX_val stub = {0, 0};
+ if (data == NULL) {
+ const unsigned mask =
+ 1 << MDBX_GET_BOTH | 1 << MDBX_GET_BOTH_RANGE | 1 << MDBX_SET_KEY;
+ if (unlikely(mask & (1 << move_op)))
+ return MDBX_EINVAL;
+ data = &stub;
+ }
+
+ if (key == NULL) {
+ const unsigned mask = 1 << MDBX_GET_BOTH | 1 << MDBX_GET_BOTH_RANGE |
+ 1 << MDBX_SET_KEY | 1 << MDBX_SET |
+ 1 << MDBX_SET_RANGE;
+ if (unlikely(mask & (1 << move_op)))
+ return MDBX_EINVAL;
+ key = &stub;
+ }
+
+ rc = mdbx_cursor_get(&next.outer, key, data, move_op);
+ if (unlikely(rc != MDBX_SUCCESS &&
+ (rc != MDBX_NOTFOUND || !(next.outer.mc_flags & C_INITIALIZED))))
+ return rc;
+
+ return mdbx_estimate_distance(cursor, &next.outer, distance_items);
+}
+
+static int mdbx_is_samedata(const MDBX_val *a, const MDBX_val *b) {
+ return a->iov_len == b->iov_len &&
+ memcmp(a->iov_base, b->iov_base, a->iov_len) == 0;
+}
+
+int mdbx_estimate_range(MDBX_txn *txn, MDBX_dbi dbi, MDBX_val *begin_key,
+ MDBX_val *begin_data, MDBX_val *end_key,
+ MDBX_val *end_data, ptrdiff_t *size_items) {
+ int rc = check_txn(txn, MDBX_TXN_BLOCKED);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ if (unlikely(!size_items))
+ return MDBX_EINVAL;
+
+ if (unlikely(begin_data && (begin_key == NULL || begin_key == MDBX_EPSILON)))
+ return MDBX_EINVAL;
+
+ if (unlikely(end_data && (end_key == NULL || end_key == MDBX_EPSILON)))
+ return MDBX_EINVAL;
+
+ if (unlikely(begin_key == MDBX_EPSILON && end_key == MDBX_EPSILON))
+ return MDBX_EINVAL;
+
+ if (unlikely(!TXN_DBI_EXIST(txn, dbi, DB_USRVALID)))
+ return MDBX_EINVAL;
+
+ MDBX_cursor_couple begin;
+ /* LY: first, initialize cursor to refresh a DB in case it have DB_STALE */
+ rc = mdbx_cursor_init(&begin.outer, txn, dbi);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ if (unlikely(begin.outer.mc_db->md_entries == 0)) {
+ *size_items = 0;
+ return MDBX_SUCCESS;
+ }
+
+ if (!begin_key) {
+ if (unlikely(!end_key)) {
+ /* LY: FIRST..LAST case */
+ *size_items = (ptrdiff_t)begin.outer.mc_db->md_entries;
+ return MDBX_SUCCESS;
+ }
+ MDBX_val stub = {0, 0};
+ rc = mdbx_cursor_first(&begin.outer, &stub, &stub);
+ if (unlikely(end_key == MDBX_EPSILON)) {
+ /* LY: FIRST..+epsilon case */
+ return (rc == MDBX_SUCCESS)
+ ? mdbx_cursor_count(&begin.outer, (size_t *)size_items)
+ : rc;
+ }
+ } else {
+ if (unlikely(begin_key == MDBX_EPSILON)) {
+ if (end_key == NULL) {
+ /* LY: -epsilon..LAST case */
+ MDBX_val stub = {0, 0};
+ rc = mdbx_cursor_last(&begin.outer, &stub, &stub);
+ return (rc == MDBX_SUCCESS)
+ ? mdbx_cursor_count(&begin.outer, (size_t *)size_items)
+ : rc;
+ }
+ /* LY: -epsilon..value case */
+ assert(end_key != MDBX_EPSILON);
+ begin_key = end_key;
+ } else if (unlikely(end_key == MDBX_EPSILON)) {
+ /* LY: value..+epsilon case */
+ assert(begin_key != MDBX_EPSILON);
+ end_key = begin_key;
+ }
+ if (end_key && !begin_data && !end_data &&
+ (begin_key == end_key || mdbx_is_samedata(begin_key, end_key))) {
+ /* LY: single key case */
+ int exact = 0;
+ rc = mdbx_cursor_set(&begin.outer, begin_key, NULL, MDBX_SET, &exact);
+ if (unlikely(rc != MDBX_SUCCESS)) {
+ *size_items = 0;
+ return (rc == MDBX_NOTFOUND) ? MDBX_SUCCESS : rc;
+ }
+ *size_items = 1;
+ if (begin.outer.mc_xcursor != NULL) {
+ MDBX_node *node = page_node(begin.outer.mc_pg[begin.outer.mc_top],
+ begin.outer.mc_ki[begin.outer.mc_top]);
+ if (F_ISSET(node_flags(node), F_DUPDATA)) {
+ /* LY: return the number of duplicates for given key */
+ mdbx_tassert(txn,
+ begin.outer.mc_xcursor == &begin.inner &&
+ (begin.inner.mx_cursor.mc_flags & C_INITIALIZED));
+ *size_items =
+ (sizeof(*size_items) >= sizeof(begin.inner.mx_db.md_entries) ||
+ begin.inner.mx_db.md_entries <= PTRDIFF_MAX)
+ ? (size_t)begin.inner.mx_db.md_entries
+ : PTRDIFF_MAX;
+ }
+ }
+ return MDBX_SUCCESS;
+ } else {
+ rc = mdbx_cursor_set(&begin.outer, begin_key, begin_data,
+ begin_data ? MDBX_GET_BOTH_RANGE : MDBX_SET_RANGE,
+ NULL);
+ }
+ }
+
+ if (unlikely(rc != MDBX_SUCCESS)) {
+ if (rc != MDBX_NOTFOUND || !(begin.outer.mc_flags & C_INITIALIZED))
+ return rc;
+ }
+
+ MDBX_cursor_couple end;
+ rc = mdbx_cursor_init(&end.outer, txn, dbi);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+ if (!end_key) {
+ MDBX_val stub = {0, 0};
+ rc = mdbx_cursor_last(&end.outer, &stub, &stub);
+ } else {
+ rc = mdbx_cursor_set(&end.outer, end_key, end_data,
+ end_data ? MDBX_GET_BOTH_RANGE : MDBX_SET_RANGE, NULL);
+ }
+ if (unlikely(rc != MDBX_SUCCESS)) {
+ if (rc != MDBX_NOTFOUND || !(end.outer.mc_flags & C_INITIALIZED))
+ return rc;
+ }
+
+ rc = mdbx_estimate_distance(&begin.outer, &end.outer, size_items);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+ assert(*size_items >= -(ptrdiff_t)begin.outer.mc_db->md_entries &&
+ *size_items <= (ptrdiff_t)begin.outer.mc_db->md_entries);
+
+#if 0 /* LY: Was decided to returns as-is (i.e. negative) the estimation \
+ * results for an inverted ranges. */
+
+ /* Commit 8ddfd1f34ad7cf7a3c4aa75d2e248ca7e639ed63
+ Change-Id: If59eccf7311123ab6384c4b93f9b1fed5a0a10d1 */
+
+ if (*size_items < 0) {
+ /* LY: inverted range case */
+ *size_items += (ptrdiff_t)begin.outer.mc_db->md_entries;
+ } else if (*size_items == 0 && begin_key && end_key) {
+ int cmp = begin.outer.mc_dbx->md_cmp(&origin_begin_key, &origin_end_key);
+ if (cmp == 0 && (begin.inner.mx_cursor.mc_flags & C_INITIALIZED) &&
+ begin_data && end_data)
+ cmp = begin.outer.mc_dbx->md_dcmp(&origin_begin_data, &origin_end_data);
+ if (cmp > 0) {
+ /* LY: inverted range case with empty scope */
+ *size_items = (ptrdiff_t)begin.outer.mc_db->md_entries;
+ }
+ }
+ assert(*size_items >= 0 &&
+ *size_items <= (ptrdiff_t)begin.outer.mc_db->md_entries);
+#endif
+
+ return MDBX_SUCCESS;
+}
+
+//------------------------------------------------------------------------------
+
+/* Позволяет обновить или удалить существующую запись с получением
+ * в old_data предыдущего значения данных. При этом если new_data равен
+ * нулю, то выполняется удаление, иначе обновление/вставка.
+ *
+ * Текущее значение может находиться в уже измененной (грязной) странице.
+ * В этом случае страница будет перезаписана при обновлении, а само старое
+ * значение утрачено. Поэтому исходно в old_data должен быть передан
+ * дополнительный буфер для копирования старого значения.
+ * Если переданный буфер слишком мал, то функция вернет -1, установив
+ * old_data->iov_len в соответствующее значение.
+ *
+ * Для не-уникальных ключей также возможен второй сценарий использования,
+ * когда посредством old_data из записей с одинаковым ключом для
+ * удаления/обновления выбирается конкретная. Для выбора этого сценария
+ * во flags следует одновременно указать MDBX_CURRENT и MDBX_NOOVERWRITE.
+ * Именно эта комбинация выбрана, так как она лишена смысла, и этим позволяет
+ * идентифицировать запрос такого сценария.
+ *
+ * Функция может быть замещена соответствующими операциями с курсорами
+ * после двух доработок (TODO):
+ * - внешняя аллокация курсоров, в том числе на стеке (без malloc).
+ * - получения статуса страницы по адресу (знать о P_DIRTY).
+ */
+int mdbx_replace(MDBX_txn *txn, MDBX_dbi dbi, MDBX_val *key, MDBX_val *new_data,
+ MDBX_val *old_data, unsigned flags) {
+ int rc = check_txn_rw(txn, MDBX_TXN_BLOCKED);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ if (unlikely(!key || !old_data || old_data == new_data))
+ return MDBX_EINVAL;
+
+ if (unlikely(old_data->iov_base == NULL && old_data->iov_len))
+ return MDBX_EINVAL;
+
+ if (unlikely(new_data == NULL && !(flags & MDBX_CURRENT)))
+ return MDBX_EINVAL;
+
+ if (unlikely(!TXN_DBI_EXIST(txn, dbi, DB_USRVALID)))
+ return MDBX_EINVAL;
+
+ if (unlikely(flags & ~(MDBX_NOOVERWRITE | MDBX_NODUPDATA | MDBX_RESERVE |
+ MDBX_APPEND | MDBX_APPENDDUP | MDBX_CURRENT)))
+ return MDBX_EINVAL;
+
+ MDBX_cursor_couple cx;
+ rc = mdbx_cursor_init(&cx.outer, txn, dbi);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+ cx.outer.mc_next = txn->mt_cursors[dbi];
+ txn->mt_cursors[dbi] = &cx.outer;
+
+ MDBX_val present_key = *key;
+ if (F_ISSET(flags, MDBX_CURRENT | MDBX_NOOVERWRITE)) {
+ /* в old_data значение для выбора конкретного дубликата */
+ if (unlikely(!(txn->mt_dbs[dbi].md_flags & MDBX_DUPSORT))) {
+ rc = MDBX_EINVAL;
+ goto bailout;
+ }
+
+ /* убираем лишний бит, он был признаком запрошенного режима */
+ flags -= MDBX_NOOVERWRITE;
+
+ rc = mdbx_cursor_get(&cx.outer, &present_key, old_data, MDBX_GET_BOTH);
+ if (rc != MDBX_SUCCESS)
+ goto bailout;
+
+ if (new_data) {
+ /* обновление конкретного дубликата */
+ if (mdbx_is_samedata(old_data, new_data))
+ /* если данные совпадают, то ничего делать не надо */
+ goto bailout;
+ }
+ } else {
+ /* в old_data буфер для сохранения предыдущего значения */
+ if (unlikely(new_data && old_data->iov_base == new_data->iov_base))
+ return MDBX_EINVAL;
+ MDBX_val present_data;
+ rc = mdbx_cursor_get(&cx.outer, &present_key, &present_data, MDBX_SET_KEY);
+ if (unlikely(rc != MDBX_SUCCESS)) {
+ old_data->iov_base = NULL;
+ old_data->iov_len = 0;
+ if (rc != MDBX_NOTFOUND || (flags & MDBX_CURRENT))
+ goto bailout;
+ } else if (flags & MDBX_NOOVERWRITE) {
+ rc = MDBX_KEYEXIST;
+ *old_data = present_data;
+ goto bailout;
+ } else {
+ MDBX_page *page = cx.outer.mc_pg[cx.outer.mc_top];
+ if (txn->mt_dbs[dbi].md_flags & MDBX_DUPSORT) {
+ if (flags & MDBX_CURRENT) {
+ /* для не-уникальных ключей позволяем update/delete только если ключ
+ * один */
+ MDBX_node *node = page_node(page, cx.outer.mc_ki[cx.outer.mc_top]);
+ if (F_ISSET(node_flags(node), F_DUPDATA)) {
+ mdbx_tassert(txn, XCURSOR_INITED(&cx.outer) &&
+ cx.outer.mc_xcursor->mx_db.md_entries > 1);
+ if (cx.outer.mc_xcursor->mx_db.md_entries > 1) {
+ rc = MDBX_EMULTIVAL;
+ goto bailout;
+ }
+ }
+ /* если данные совпадают, то ничего делать не надо */
+ if (new_data && mdbx_is_samedata(&present_data, new_data)) {
+ *old_data = *new_data;
+ goto bailout;
+ }
+ /* В оригинальной LMDB флажок MDBX_CURRENT здесь приведет
+ * к замене данных без учета MDBX_DUPSORT сортировки,
+ * но здесь это в любом случае допустимо, так как мы
+ * проверили что для ключа есть только одно значение. */
+ } else if ((flags & MDBX_NODUPDATA) &&
+ mdbx_is_samedata(&present_data, new_data)) {
+ /* если данные совпадают и установлен MDBX_NODUPDATA */
+ rc = MDBX_KEYEXIST;
+ goto bailout;
+ }
+ } else {
+ /* если данные совпадают, то ничего делать не надо */
+ if (new_data && mdbx_is_samedata(&present_data, new_data)) {
+ *old_data = *new_data;
+ goto bailout;
+ }
+ flags |= MDBX_CURRENT;
+ }
+
+ if (IS_DIRTY(page)) {
+ if (unlikely(old_data->iov_len < present_data.iov_len)) {
+ old_data->iov_base = NULL;
+ old_data->iov_len = present_data.iov_len;
+ rc = MDBX_RESULT_TRUE;
+ goto bailout;
+ }
+ memcpy(old_data->iov_base, present_data.iov_base, present_data.iov_len);
+ old_data->iov_len = present_data.iov_len;
+ } else {
+ *old_data = present_data;
+ }
+ }
+ }
+
+ if (likely(new_data))
+ rc = mdbx_cursor_put(&cx.outer, key, new_data, flags);
+ else
+ rc = mdbx_cursor_del(&cx.outer, 0);
+
+bailout:
+ txn->mt_cursors[dbi] = cx.outer.mc_next;
+ return rc;
+}
+
+/* Функция сообщает находится ли указанный адрес в "грязной" странице у
+ * заданной пишущей транзакции. В конечном счете это позволяет избавиться от
+ * лишнего копирования данных из НЕ-грязных страниц.
+ *
+ * "Грязные" страницы - это те, которые уже были изменены в ходе пишущей
+ * транзакции. Соответственно, какие-либо дальнейшие изменения могут привести
+ * к перезаписи таких страниц. Поэтому все функции, выполняющие изменения, в
+ * качестве аргументов НЕ должны получать указатели на данные в таких
+ * страницах. В свою очередь "НЕ грязные" страницы перед модификацией будут
+ * скопированы.
+ *
+ * Другими словами, данные из "грязных" страниц должны быть либо скопированы
+ * перед передачей в качестве аргументов для дальнейших модификаций, либо
+ * отвергнуты на стадии проверки корректности аргументов.
+ *
+ * Таким образом, функция позволяет как избавиться от лишнего копирования,
+ * так и выполнить более полную проверку аргументов.
+ *
+ * ВАЖНО: Передаваемый указатель должен указывать на начало данных. Только
+ * так гарантируется что актуальный заголовок страницы будет физически
+ * расположен в той-же странице памяти, в том числе для многостраничных
+ * P_OVERFLOW страниц с длинными данными. */
+int mdbx_is_dirty(const MDBX_txn *txn, const void *ptr) {
+ int rc = check_txn(txn, MDBX_TXN_BLOCKED);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ if (txn->mt_flags & MDBX_RDONLY)
+ return MDBX_RESULT_FALSE;
+
+ const MDBX_env *env = txn->mt_env;
+ const ptrdiff_t offset = (uint8_t *)ptr - env->me_map;
+ if (offset >= 0) {
+ const pgno_t pgno = bytes2pgno(env, offset);
+ if (likely(pgno < txn->mt_next_pgno)) {
+ const MDBX_page *page = pgno2page(env, pgno);
+ if (unlikely(page->mp_pgno != pgno)) {
+ /* The ptr pointed into middle of a large page,
+ * not to the beginning of a data. */
+ return MDBX_EINVAL;
+ }
+ if (unlikely(page->mp_flags & (P_DIRTY | P_LOOSE | P_KEEP)))
+ return MDBX_RESULT_TRUE;
+ if (likely(txn->tw.spill_pages == nullptr))
+ return MDBX_RESULT_FALSE;
+ return mdbx_pnl_exist(txn->tw.spill_pages, pgno << 1) ? MDBX_RESULT_TRUE
+ : MDBX_RESULT_FALSE;
+ }
+ if ((size_t)offset < env->me_dxb_mmap.limit) {
+ /* Указатель адресует что-то в пределах mmap, но за границей
+ * распределенных страниц. Такое может случится если mdbx_is_dirty()
+ * вызывает после операции, в ходе которой гразная страница попала
+ * в loose и затем была возвращена в нераспределенное пространство. */
+ return MDBX_RESULT_TRUE;
+ }
+ }
+
+ /* Страница вне используемого mmap-диапазона, т.е. либо в функцию был
+ * передан некорректный адрес, либо адрес в теневой странице, которая была
+ * выделена посредством malloc().
+ *
+ * Для WRITE_MAP режима такая страница однозначно "не грязная",
+ * а для режимов без WRITE_MAP следует просматривать списки dirty
+ * и spilled страниц у каких-либо транзакций (в том числе дочерних).
+ *
+ * Поэтому для WRITE_MAP возвращаем false, а для остальных режимов
+ * всегда true. Такая логика имеет ряд преимуществ:
+ * - не тратим время на просмотр списков;
+ * - результат всегда безопасен (может быть ложно-положительным,
+ * но не ложно-отрицательным);
+ * - результат не зависит от вложенности транзакций и от относительного
+ * положения переданной транзакции в этой рекурсии. */
+ return (env->me_flags & MDBX_WRITEMAP) ? MDBX_RESULT_FALSE : MDBX_RESULT_TRUE;
+}
+
+int mdbx_dbi_sequence(MDBX_txn *txn, MDBX_dbi dbi, uint64_t *result,
+ uint64_t increment) {
+ int rc = check_txn(txn, MDBX_TXN_BLOCKED);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ if (unlikely(!TXN_DBI_EXIST(txn, dbi, DB_USRVALID)))
+ return MDBX_EINVAL;
+
+ if (unlikely(TXN_DBI_CHANGED(txn, dbi)))
+ return MDBX_BAD_DBI;
+
+ if (unlikely(txn->mt_dbflags[dbi] & DB_STALE)) {
+ rc = mdbx_fetch_sdb(txn, dbi);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+ }
+
+ MDBX_db *dbs = &txn->mt_dbs[dbi];
+ if (likely(result))
+ *result = dbs->md_seq;
+
+ if (likely(increment > 0)) {
+ if (unlikely(txn->mt_flags & MDBX_RDONLY))
+ return MDBX_EACCESS;
+
+ uint64_t new = dbs->md_seq + increment;
+ if (unlikely(new < increment))
+ return MDBX_RESULT_TRUE;
+
+ mdbx_tassert(txn, new > dbs->md_seq);
+ dbs->md_seq = new;
+ txn->mt_flags |= MDBX_TXN_DIRTY;
+ txn->mt_dbflags[dbi] |= DB_DIRTY;
+ }
+
+ return MDBX_SUCCESS;
+}
+
+/*----------------------------------------------------------------------------*/
+
+__cold intptr_t mdbx_limits_keysize_max(intptr_t pagesize) {
+ if (pagesize < 1)
+ pagesize = (intptr_t)mdbx_syspagesize();
+ else if (unlikely(pagesize < (intptr_t)MIN_PAGESIZE ||
+ pagesize > (intptr_t)MAX_PAGESIZE ||
+ !is_powerof2((size_t)pagesize)))
+ return (MDBX_EINVAL > 0) ? -MDBX_EINVAL : MDBX_EINVAL;
+
+ return mdbx_maxkey(mdbx_nodemax(pagesize));
+}
+
+__cold intptr_t mdbx_limits_dbsize_min(intptr_t pagesize) {
+ if (pagesize < 1)
+ pagesize = (intptr_t)mdbx_syspagesize();
+ else if (unlikely(pagesize < (intptr_t)MIN_PAGESIZE ||
+ pagesize > (intptr_t)MAX_PAGESIZE ||
+ !is_powerof2((size_t)pagesize)))
+ return (MDBX_EINVAL > 0) ? -MDBX_EINVAL : MDBX_EINVAL;
+
+ return MIN_PAGENO * pagesize;
+}
+
+__cold intptr_t mdbx_limits_dbsize_max(intptr_t pagesize) {
+ if (pagesize < 1)
+ pagesize = (intptr_t)mdbx_syspagesize();
+ else if (unlikely(pagesize < (intptr_t)MIN_PAGESIZE ||
+ pagesize > (intptr_t)MAX_PAGESIZE ||
+ !is_powerof2((size_t)pagesize)))
+ return (MDBX_EINVAL > 0) ? -MDBX_EINVAL : MDBX_EINVAL;
+
+ const uint64_t limit = MAX_PAGENO * (uint64_t)pagesize;
+ return (limit < (intptr_t)MAX_MAPSIZE) ? (intptr_t)limit
+ : (intptr_t)MAX_MAPSIZE;
+}
+
+__cold intptr_t mdbx_limits_txnsize_max(intptr_t pagesize) {
+ if (pagesize < 1)
+ pagesize = (intptr_t)mdbx_syspagesize();
+ else if (unlikely(pagesize < (intptr_t)MIN_PAGESIZE ||
+ pagesize > (intptr_t)MAX_PAGESIZE ||
+ !is_powerof2((size_t)pagesize)))
+ return (MDBX_EINVAL > 0) ? -MDBX_EINVAL : MDBX_EINVAL;
+
+ return pagesize * (MDBX_DPL_TXNFULL - 1);
+}
+
+/*** Attribute support functions for Nexenta **********************************/
+#ifdef MDBX_NEXENTA_ATTRS
+
+static __inline int mdbx_attr_peek(MDBX_val *data, mdbx_attr_t *attrptr) {
+ if (unlikely(data->iov_len < sizeof(mdbx_attr_t)))
+ return MDBX_INCOMPATIBLE;
+
+ if (likely(attrptr != NULL))
+ *attrptr = *(mdbx_attr_t *)data->iov_base;
+ data->iov_len -= sizeof(mdbx_attr_t);
+ data->iov_base =
+ likely(data->iov_len > 0) ? ((mdbx_attr_t *)data->iov_base) + 1 : NULL;
+
+ return MDBX_SUCCESS;
+}
+
+static __inline int mdbx_attr_poke(MDBX_val *reserved, MDBX_val *data,
+ mdbx_attr_t attr, unsigned flags) {
+ mdbx_attr_t *space = reserved->iov_base;
+ if (flags & MDBX_RESERVE) {
+ if (likely(data != NULL)) {
+ data->iov_base = data->iov_len ? space + 1 : NULL;
+ }
+ } else {
+ *space = attr;
+ if (likely(data != NULL)) {
+ memcpy(space + 1, data->iov_base, data->iov_len);
+ }
+ }
+
+ return MDBX_SUCCESS;
+}
+
+int mdbx_cursor_get_attr(MDBX_cursor *mc, MDBX_val *key, MDBX_val *data,
+ mdbx_attr_t *attrptr, MDBX_cursor_op op) {
+ int rc = mdbx_cursor_get(mc, key, data, op);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ return mdbx_attr_peek(data, attrptr);
+}
+
+int mdbx_get_attr(MDBX_txn *txn, MDBX_dbi dbi, MDBX_val *key, MDBX_val *data,
+ uint64_t *attrptr) {
+ int rc = mdbx_get(txn, dbi, key, data);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ return mdbx_attr_peek(data, attrptr);
+}
+
+int mdbx_put_attr(MDBX_txn *txn, MDBX_dbi dbi, MDBX_val *key, MDBX_val *data,
+ mdbx_attr_t attr, unsigned flags) {
+ MDBX_val reserve;
+ reserve.iov_base = NULL;
+ reserve.iov_len = (data ? data->iov_len : 0) + sizeof(mdbx_attr_t);
+
+ int rc = mdbx_put(txn, dbi, key, &reserve, flags | MDBX_RESERVE);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ return mdbx_attr_poke(&reserve, data, attr, flags);
+}
+
+int mdbx_cursor_put_attr(MDBX_cursor *cursor, MDBX_val *key, MDBX_val *data,
+ mdbx_attr_t attr, unsigned flags) {
+ MDBX_val reserve;
+ reserve.iov_base = NULL;
+ reserve.iov_len = (data ? data->iov_len : 0) + sizeof(mdbx_attr_t);
+
+ int rc = mdbx_cursor_put(cursor, key, &reserve, flags | MDBX_RESERVE);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ return mdbx_attr_poke(&reserve, data, attr, flags);
+}
+
+int mdbx_set_attr(MDBX_txn *txn, MDBX_dbi dbi, MDBX_val *key, MDBX_val *data,
+ mdbx_attr_t attr) {
+ if (unlikely(!key || !txn))
+ return MDBX_EINVAL;
+
+ if (unlikely(txn->mt_signature != MDBX_MT_SIGNATURE))
+ return MDBX_VERSION_MISMATCH;
+
+ if (unlikely(!TXN_DBI_EXIST(txn, dbi, DB_USRVALID)))
+ return MDBX_EINVAL;
+
+ if (unlikely(txn->mt_flags & (MDBX_RDONLY | MDBX_TXN_BLOCKED)))
+ return (txn->mt_flags & MDBX_RDONLY) ? MDBX_EACCESS : MDBX_BAD_TXN;
+
+ MDBX_cursor_couple cx;
+ MDBX_val old_data;
+ int rc = mdbx_cursor_init(&cx.outer, txn, dbi);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+ rc = mdbx_cursor_set(&cx.outer, key, &old_data, MDBX_SET, NULL);
+ if (unlikely(rc != MDBX_SUCCESS)) {
+ if (rc == MDBX_NOTFOUND && data) {
+ cx.outer.mc_next = txn->mt_cursors[dbi];
+ txn->mt_cursors[dbi] = &cx.outer;
+ rc = mdbx_cursor_put_attr(&cx.outer, key, data, attr, 0);
+ txn->mt_cursors[dbi] = cx.outer.mc_next;
+ }
+ return rc;
+ }
+
+ mdbx_attr_t old_attr = 0;
+ rc = mdbx_attr_peek(&old_data, &old_attr);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+
+ if (old_attr == attr && (!data || (data->iov_len == old_data.iov_len &&
+ memcmp(data->iov_base, old_data.iov_base,
+ old_data.iov_len) == 0)))
+ return MDBX_SUCCESS;
+
+ cx.outer.mc_next = txn->mt_cursors[dbi];
+ txn->mt_cursors[dbi] = &cx.outer;
+ rc = mdbx_cursor_put_attr(&cx.outer, key, data ? data : &old_data, attr,
+ MDBX_CURRENT);
+ txn->mt_cursors[dbi] = cx.outer.mc_next;
+ return rc;
+}
+#endif /* MDBX_NEXENTA_ATTRS */
+
+/******************************************************************************/
+/* *INDENT-OFF* */
+/* clang-format off */
+
+__dll_export
+#ifdef __attribute_used__
+ __attribute_used__
+#elif defined(__GNUC__) || __has_attribute(__used__)
+ __attribute__((__used__))
+#endif
+#ifdef __attribute_externally_visible__
+ __attribute_externally_visible__
+#elif (defined(__GNUC__) && !defined(__clang__)) || \
+ __has_attribute(__externally_visible__)
+ __attribute__((__externally_visible__))
+#endif
+ const mdbx_build_info mdbx_build = {
+#ifdef MDBX_BUILD_TIMESTAMP
+ MDBX_BUILD_TIMESTAMP
+#else
+ __DATE__ " " __TIME__
+#endif /* MDBX_BUILD_TIMESTAMP */
+
+ ,
+#ifdef MDBX_BUILD_TARGET
+ MDBX_BUILD_TARGET
+#else
+ #if defined(__ANDROID__)
+ "Android"
+ #elif defined(__linux__) || defined(__gnu_linux__)
+ "Linux"
+ #elif defined(EMSCRIPTEN) || defined(__EMSCRIPTEN__)
+ "webassembly"
+ #elif defined(__CYGWIN__)
+ "CYGWIN"
+ #elif defined(_WIN64) || defined(_WIN32) || defined(__TOS_WIN__) \
+ || defined(__WINDOWS__)
+ "Windows"
+ #elif defined(__APPLE__)
+ #if (defined(TARGET_OS_IPHONE) && TARGET_OS_IPHONE) \
+ || (defined(TARGET_IPHONE_SIMULATOR) && TARGET_IPHONE_SIMULATOR)
+ "iOS"
+ #else
+ "MacOS"
+ #endif
+ #elif defined(__FreeBSD__)
+ "FreeBSD"
+ #elif defined(__DragonFly__)
+ "DragonFlyBSD"
+ #elif defined(__NetBSD__) || defined(__NETBSD__)
+ "NetBSD"
+ #elif defined(__OpenBSD__)
+ "OpenBSD"
+ #elif defined(__bsdi__)
+ "UnixBSDI"
+ #elif defined(__MACH__)
+ "MACH"
+ #elif (defined(_HPUX_SOURCE) || defined(__hpux) || defined(__HP_aCC))
+ "HPUX"
+ #elif defined(_AIX)
+ "AIX"
+ #elif defined(__sun) && defined(__SVR4)
+ "Solaris"
+ #elif defined(__BSD__) || defined(BSD)
+ "UnixBSD"
+ #elif defined(__unix__) || defined(UNIX) || defined(__unix) \
+ || defined(__UNIX) || defined(__UNIX__)
+ "UNIX"
+ #elif defined(_POSIX_VERSION)
+ "POSIX" STRINGIFY(_POSIX_VERSION)
+ #else
+ "UnknownOS"
+ #endif /* Target OS */
+
+ "-"
+
+ #if defined(__amd64__)
+ "AMD64"
+ #elif defined(__ia32__)
+ "IA32"
+ #elif defined(__e2k__) || defined(__elbrus__)
+ "Elbrus"
+ #elif defined(__alpha__) || defined(__alpha) || defined(_M_ALPHA)
+ "Alpha"
+ #elif defined(__aarch64__) || defined(_M_ARM64)
+ "ARM64"
+ #elif defined(__arm__) || defined(__thumb__) || defined(__TARGET_ARCH_ARM) \
+ || defined(__TARGET_ARCH_THUMB) || defined(_ARM) || defined(_M_ARM) \
+ || defined(_M_ARMT) || defined(__arm)
+ "ARM"
+ #elif defined(__mips64) || defined(__mips64__) || (defined(__mips) && (__mips >= 64))
+ "MIPS64"
+ #elif if defined(__mips__) || defined(__mips) || defined(_R4000) || defined(__MIPS__)
+ "MIPS"
+ #elif defined(__hppa64__) || defined(__HPPA64__) || defined(__hppa64)
+ "PARISC64"
+ #elif defined(__hppa__) || defined(__HPPA__) || defined(__hppa)
+ "PARISC"
+ #elif defined(__ia64__) || defined(__ia64) || defined(_IA64) \
+ || defined(__IA64__) || defined(_M_IA64) || defined(__itanium__)
+ "Itanium"
+ #elif defined(__powerpc64__) || defined(__ppc64__) || defined(__ppc64) \
+ || defined(__powerpc64) || defined(_ARCH_PPC64)
+ "PowerPC64"
+ #elif defined(__powerpc__) || defined(__ppc__) || defined(__powerpc) \
+ || defined(__ppc) || defined(_ARCH_PPC) || defined(__PPC__) || defined(__POWERPC__)
+ "PowerPC"
+ #elif defined(__sparc64__) || defined(__sparc64)
+ "SPARC64"
+ #elif defined(__sparc__) || defined(__sparc)
+ "SPARC"
+ #elif defined(__s390__) || defined(__s390) || defined(__zarch__) || defined(__zarch)
+ "S390"
+ #else
+ "UnknownARCH"
+ #endif
+#endif /* MDBX_BUILD_TARGET */
+
+#ifdef MDBX_BUILD_CONFIG
+# if defined(_MSC_VER)
+# pragma message("Configuration-depended MDBX_BUILD_CONFIG: " MDBX_BUILD_CONFIG)
+# endif
+ "-" MDBX_BUILD_CONFIG
+#endif /* MDBX_BUILD_CONFIG */
+ ,
+ "MDBX_DEBUG=" STRINGIFY(MDBX_DEBUG)
+#ifdef MDBX_LOGLEVEL_BUILD
+ " MDBX_LOGLEVEL_BUILD=" STRINGIFY(MDBX_LOGLEVEL_BUILD)
+#endif /* MDBX_LOGLEVEL_BUILD */
+ " MDBX_WORDBITS=" STRINGIFY(MDBX_WORDBITS)
+ " BYTE_ORDER="
+#if __BYTE_ORDER__ == __ORDER_LITTLE_ENDIAN__
+ "LITTLE_ENDIAN"
+#elif __BYTE_ORDER__ == __ORDER_BIG_ENDIAN__
+ "BIG_ENDIAN"
+#else
+ #error "FIXME: Unsupported byte order"
+#endif /* __BYTE_ORDER__ */
+ " MDBX_TXN_CHECKPID=" MDBX_TXN_CHECKPID_CONFIG
+ " MDBX_TXN_CHECKOWNER=" MDBX_TXN_CHECKOWNER_CONFIG
+ " MDBX_64BIT_ATOMIC=" MDBX_64BIT_ATOMIC_CONFIG
+ " MDBX_64BIT_CAS=" MDBX_64BIT_CAS_CONFIG
+ " MDBX_TRUST_RTC=" MDBX_TRUST_RTC_CONFIG
+#ifdef __SANITIZE_ADDRESS__
+ " SANITIZE_ADDRESS=YES"
+#endif /* __SANITIZE_ADDRESS__ */
+#ifdef MDBX_USE_VALGRIND
+ " MDBX_USE_VALGRIND=YES"
+#endif /* MDBX_USE_VALGRIND */
+#ifdef _GNU_SOURCE
+ " _GNU_SOURCE=YES"
+#else
+ " _GNU_SOURCE=NO"
+#endif /* _GNU_SOURCE */
+#ifdef __APPLE__
+ " MDBX_OSX_SPEED_INSTEADOF_DURABILITY=" STRINGIFY(MDBX_OSX_SPEED_INSTEADOF_DURABILITY)
+#endif /* MacOS */
+#if defined(_WIN32) || defined(_WIN64)
+ " MDBX_AVOID_CRT=" STRINGIFY(MDBX_AVOID_CRT)
+ " MDBX_CONFIG_MANUAL_TLS_CALLBACK=" STRINGIFY(MDBX_CONFIG_MANUAL_TLS_CALLBACK)
+ " MDBX_BUILD_SHARED_LIBRARY=" STRINGIFY(MDBX_BUILD_SHARED_LIBRARY)
+ " WINVER=" STRINGIFY(WINVER)
+#else /* Windows */
+ " MDBX_USE_ROBUST=" MDBX_USE_ROBUST_CONFIG
+ " MDBX_USE_OFDLOCKS=" MDBX_USE_OFDLOCKS_CONFIG
+#endif /* !Windows */
+#ifdef MDBX_OSAL_LOCK
+ " MDBX_OSAL_LOCK=" STRINGIFY(MDBX_OSAL_LOCK)
+#endif
+ " MDBX_CACHELINE_SIZE=" STRINGIFY(MDBX_CACHELINE_SIZE)
+ " MDBX_CPU_WRITEBACK_IS_COHERENT=" STRINGIFY(MDBX_CPU_WRITEBACK_IS_COHERENT)
+ " MDBX_UNALIGNED_OK=" STRINGIFY(MDBX_UNALIGNED_OK)
+ " MDBX_PNL_ASCENDING=" STRINGIFY(MDBX_PNL_ASCENDING)
+ ,
+#ifdef MDBX_BUILD_COMPILER
+ MDBX_BUILD_COMPILER
+#else
+ #ifdef __INTEL_COMPILER
+ "Intel C/C++ " STRINGIFY(__INTEL_COMPILER)
+ #elsif defined(__apple_build_version__)
+ "Apple clang " STRINGIFY(__apple_build_version__)
+ #elif defined(__ibmxl__)
+ "IBM clang C " STRINGIFY(__ibmxl_version__) "." STRINGIFY(__ibmxl_release__)
+ "." STRINGIFY(__ibmxl_modification__) "." STRINGIFY(__ibmxl_ptf_fix_level__)
+ #elif defined(__clang__)
+ "clang " STRINGIFY(__clang_version__)
+ #elif defined(__MINGW64__)
+ "MINGW-64 " STRINGIFY(__MINGW64_MAJOR_VERSION) "." STRINGIFY(__MINGW64_MINOR_VERSION)
+ #elif defined(__MINGW32__)
+ "MINGW-32 " STRINGIFY(__MINGW32_MAJOR_VERSION) "." STRINGIFY(__MINGW32_MINOR_VERSION)
+ #elif defined(__IBMC__)
+ "IBM C " STRINGIFY(__IBMC__)
+ #elif defined(__GNUC__)
+ "GNU C/C++ "
+ #ifdef __VERSION__
+ __VERSION__
+ #else
+ STRINGIFY(__GNUC__) "." STRINGIFY(__GNUC_MINOR__) "." STRINGIFY(__GNUC_PATCHLEVEL__)
+ #endif
+ #elif defined(_MSC_VER)
+ "MSVC " STRINGIFY(_MSC_FULL_VER) "-" STRINGIFY(_MSC_BUILD)
+ #else
+ "Unknown compiler"
+ #endif
+#endif /* MDBX_BUILD_COMPILER */
+ ,
+#ifdef MDBX_BUILD_FLAGS
+ MDBX_BUILD_FLAGS
+#endif /* MDBX_BUILD_FLAGS */
+#ifdef MDBX_BUILD_FLAGS_CONFIG
+ MDBX_BUILD_FLAGS_CONFIG
+#endif /* MDBX_BUILD_FLAGS_CONFIG */
+};
+
+#ifdef __SANITIZE_ADDRESS__
+LIBMDBX_API __attribute__((__weak__)) const char *__asan_default_options() {
+ return "symbolize=1:allow_addr2line=1:"
+#ifdef _DEBUG
+ "debug=1:"
+#endif /* _DEBUG */
+ "report_globals=1:"
+ "replace_str=1:replace_intrin=1:"
+ "malloc_context_size=9:"
+ "detect_leaks=1:"
+ "check_printf=1:"
+ "detect_deadlocks=1:"
+#ifndef LTO_ENABLED
+ "check_initialization_order=1:"
+#endif
+ "detect_stack_use_after_return=1:"
+ "intercept_tls_get_addr=1:"
+ "decorate_proc_maps=1:"
+ "abort_on_error=1";
+}
+#endif /* __SANITIZE_ADDRESS__ */
+
+/* *INDENT-ON* */
+/* clang-format on */
diff --git a/contrib/db/libmdbx/src/elements/defs.h b/contrib/db/libmdbx/src/elements/defs.h
new file mode 100644
index 00000000..aba07f9a
--- /dev/null
+++ b/contrib/db/libmdbx/src/elements/defs.h
@@ -0,0 +1,450 @@
+/*
+ * Copyright 2015-2019 Leonid Yuriev
+ * and other libmdbx authors: please see AUTHORS file.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted only as authorized by the OpenLDAP
+ * Public License.
+ *
+ * A copy of this license is available in the file LICENSE in the
+ * top-level directory of the distribution or, alternatively, at
+ * .
+ */
+
+#pragma once
+/* *INDENT-OFF* */
+/* clang-format off */
+
+#ifndef __GNUC_PREREQ
+# if defined(__GNUC__) && defined(__GNUC_MINOR__)
+# define __GNUC_PREREQ(maj, min) \
+ ((__GNUC__ << 16) + __GNUC_MINOR__ >= ((maj) << 16) + (min))
+# else
+# define __GNUC_PREREQ(maj, min) (0)
+# endif
+#endif /* __GNUC_PREREQ */
+
+#ifndef __CLANG_PREREQ
+# ifdef __clang__
+# define __CLANG_PREREQ(maj,min) \
+ ((__clang_major__ << 16) + __clang_minor__ >= ((maj) << 16) + (min))
+# else
+# define __CLANG_PREREQ(maj,min) (0)
+# endif
+#endif /* __CLANG_PREREQ */
+
+#ifndef __GLIBC_PREREQ
+# if defined(__GLIBC__) && defined(__GLIBC_MINOR__)
+# define __GLIBC_PREREQ(maj, min) \
+ ((__GLIBC__ << 16) + __GLIBC_MINOR__ >= ((maj) << 16) + (min))
+# else
+# define __GLIBC_PREREQ(maj, min) (0)
+# endif
+#endif /* __GLIBC_PREREQ */
+
+#ifndef __has_attribute
+# define __has_attribute(x) (0)
+#endif
+
+#ifndef __has_feature
+# define __has_feature(x) (0)
+#endif
+
+#ifndef __has_extension
+# define __has_extension(x) (0)
+#endif
+
+#ifndef __has_builtin
+# define __has_builtin(x) (0)
+#endif
+
+#ifndef __has_warning
+# define __has_warning(x) (0)
+#endif
+
+#ifndef __has_include
+# define __has_include(x) (0)
+#endif
+
+#if __has_feature(thread_sanitizer)
+# define __SANITIZE_THREAD__ 1
+#endif
+
+#if __has_feature(address_sanitizer)
+# define __SANITIZE_ADDRESS__ 1
+#endif
+
+/*----------------------------------------------------------------------------*/
+
+#ifndef __extern_C
+# ifdef __cplusplus
+# define __extern_C extern "C"
+# else
+# define __extern_C
+# endif
+#endif /* __extern_C */
+
+#ifndef __cplusplus
+# ifndef bool
+# define bool _Bool
+# endif
+# ifndef true
+# define true (1)
+# endif
+# ifndef false
+# define false (0)
+# endif
+#endif
+
+#if !defined(nullptr) && !defined(__cplusplus) || (__cplusplus < 201103L && !defined(_MSC_VER))
+# define nullptr NULL
+#endif
+
+/*----------------------------------------------------------------------------*/
+
+#ifndef __always_inline
+# if defined(__GNUC__) || __has_attribute(__always_inline__)
+# define __always_inline __inline __attribute__((__always_inline__))
+# elif defined(_MSC_VER)
+# define __always_inline __forceinline
+# else
+# define __always_inline
+# endif
+#endif /* __always_inline */
+
+#ifndef __noinline
+# if defined(__GNUC__) || __has_attribute(__noinline__)
+# define __noinline __attribute__((__noinline__))
+# elif defined(_MSC_VER)
+# define __noinline __declspec(noinline)
+# elif defined(__SUNPRO_C) || defined(__sun) || defined(sun)
+# define __noinline inline
+# elif !defined(__INTEL_COMPILER)
+# define __noinline /* FIXME ? */
+# endif
+#endif /* __noinline */
+
+#ifndef __must_check_result
+# if defined(__GNUC__) || __has_attribute(__warn_unused_result__)
+# define __must_check_result __attribute__((__warn_unused_result__))
+# else
+# define __must_check_result
+# endif
+#endif /* __must_check_result */
+
+#ifndef __maybe_unused
+# if defined(__GNUC__) || __has_attribute(__unused__)
+# define __maybe_unused __attribute__((__unused__))
+# else
+# define __maybe_unused
+# endif
+#endif /* __maybe_unused */
+
+#ifndef __deprecated
+# if defined(__GNUC__) || __has_attribute(__deprecated__)
+# define __deprecated __attribute__((__deprecated__))
+# elif defined(_MSC_VER)
+# define __deprecated __declspec(deprecated)
+# else
+# define __deprecated
+# endif
+#endif /* __deprecated */
+
+#if !defined(__noop) && !defined(_MSC_VER)
+# define __noop(...) do {} while(0)
+#endif /* __noop */
+
+#ifndef __fallthrough
+# if __GNUC_PREREQ(7, 0) || __has_attribute(__fallthrough__)
+# define __fallthrough __attribute__((__fallthrough__))
+# else
+# define __fallthrough __noop()
+# endif
+#endif /* __fallthrough */
+
+#ifndef __unreachable
+# if __GNUC_PREREQ(4,5)
+# define __unreachable() __builtin_unreachable()
+# elif defined(_MSC_VER)
+# define __unreachable() __assume(0)
+# else
+# define __unreachable() __noop()
+# endif
+#endif /* __unreachable */
+
+#ifndef __prefetch
+# if defined(__GNUC__) || defined(__clang__)
+# define __prefetch(ptr) __builtin_prefetch(ptr)
+# else
+# define __prefetch(ptr) __noop(ptr)
+# endif
+#endif /* __prefetch */
+
+#ifndef __noreturn
+# if defined(__GNUC__) || __has_attribute(__noreturn__)
+# define __noreturn __attribute__((__noreturn__))
+# elif defined(_MSC_VER)
+# define __noreturn __declspec(noreturn)
+# else
+# define __noreturn
+# endif
+#endif /* __noreturn */
+
+#ifndef __nothrow
+# if defined(__cplusplus)
+# if __cplusplus < 201703L
+# define __nothrow throw()
+# else
+# define __nothrow noexcept(true)
+# endif /* __cplusplus */
+# elif defined(__GNUC__) || __has_attribute(__nothrow__)
+# define __nothrow __attribute__((__nothrow__))
+# elif defined(_MSC_VER) && defined(__cplusplus)
+# define __nothrow __declspec(nothrow)
+# else
+# define __nothrow
+# endif
+#endif /* __nothrow */
+
+#ifndef __pure_function
+ /* Many functions have no effects except the return value and their
+ * return value depends only on the parameters and/or global variables.
+ * Such a function can be subject to common subexpression elimination
+ * and loop optimization just as an arithmetic operator would be.
+ * These functions should be declared with the attribute pure. */
+# if defined(__GNUC__) || __has_attribute(__pure__)
+# define __pure_function __attribute__((__pure__))
+# else
+# define __pure_function
+# endif
+#endif /* __pure_function */
+
+#ifndef __const_function
+ /* Many functions do not examine any values except their arguments,
+ * and have no effects except the return value. Basically this is just
+ * slightly more strict class than the PURE attribute, since function
+ * is not allowed to read global memory.
+ *
+ * Note that a function that has pointer arguments and examines the
+ * data pointed to must not be declared const. Likewise, a function
+ * that calls a non-const function usually must not be const.
+ * It does not make sense for a const function to return void. */
+# if defined(__GNUC__) || __has_attribute(__const__)
+# define __const_function __attribute__((__const__))
+# else
+# define __const_function
+# endif
+#endif /* __const_function */
+
+#ifndef __hidden
+# if defined(__GNUC__) || __has_attribute(__visibility__)
+# define __hidden __attribute__((__visibility__("hidden")))
+# else
+# define __hidden
+# endif
+#endif /* __hidden */
+
+#ifndef __optimize
+# if defined(__OPTIMIZE__)
+# if defined(__clang__) && !__has_attribute(__optimize__)
+# define __optimize(ops)
+# elif defined(__GNUC__) || __has_attribute(__optimize__)
+# define __optimize(ops) __attribute__((__optimize__(ops)))
+# else
+# define __optimize(ops)
+# endif
+# else
+# define __optimize(ops)
+# endif
+#endif /* __optimize */
+
+#ifndef __hot
+# if defined(__OPTIMIZE__)
+# if defined(__e2k__)
+# define __hot __attribute__((__hot__)) __optimize(3)
+# elif defined(__clang__) && !__has_attribute(__hot_) \
+ && __has_attribute(__section__) && (defined(__linux__) || defined(__gnu_linux__))
+ /* just put frequently used functions in separate section */
+# define __hot __attribute__((__section__("text.hot"))) __optimize("O3")
+# elif defined(__GNUC__) || __has_attribute(__hot__)
+# define __hot __attribute__((__hot__)) __optimize("O3")
+# else
+# define __hot __optimize("O3")
+# endif
+# else
+# define __hot
+# endif
+#endif /* __hot */
+
+#ifndef __cold
+# if defined(__OPTIMIZE__)
+# if defined(__e2k__)
+# define __cold __attribute__((__cold__)) __optimize(1)
+# elif defined(__clang__) && !__has_attribute(cold) \
+ && __has_attribute(__section__) && (defined(__linux__) || defined(__gnu_linux__))
+ /* just put infrequently used functions in separate section */
+# define __cold __attribute__((__section__("text.unlikely"))) __optimize("Os")
+# elif defined(__GNUC__) || __has_attribute(cold)
+# define __cold __attribute__((__cold__)) __optimize("Os")
+# else
+# define __cold __optimize("Os")
+# endif
+# else
+# define __cold
+# endif
+#endif /* __cold */
+
+#ifndef __flatten
+# if defined(__OPTIMIZE__) && (defined(__GNUC__) || __has_attribute(__flatten__))
+# define __flatten __attribute__((__flatten__))
+# else
+# define __flatten
+# endif
+#endif /* __flatten */
+
+#ifndef likely
+# if (defined(__GNUC__) || defined(__clang__)) && !defined(__COVERITY__)
+# define likely(cond) __builtin_expect(!!(cond), 1)
+# else
+# define likely(x) (x)
+# endif
+#endif /* likely */
+
+#ifndef unlikely
+# if (defined(__GNUC__) || defined(__clang__)) && !defined(__COVERITY__)
+# define unlikely(cond) __builtin_expect(!!(cond), 0)
+# else
+# define unlikely(x) (x)
+# endif
+#endif /* unlikely */
+
+/* Workaround for Coverity Scan */
+#if defined(__COVERITY__) && __GNUC_PREREQ(7, 0) && !defined(__cplusplus)
+typedef float _Float32;
+typedef double _Float32x;
+typedef double _Float64;
+typedef long double _Float64x;
+typedef float _Float128 __attribute__((__mode__(__TF__)));
+typedef __complex__ float __cfloat128 __attribute__ ((__mode__ (__TC__)));
+typedef _Complex float __cfloat128 __attribute__ ((__mode__ (__TC__)));
+#endif /* Workaround for Coverity Scan */
+
+#ifndef __printf_args
+# if defined(__GNUC__) || __has_attribute(__format__)
+# define __printf_args(format_index, first_arg) \
+ __attribute__((__format__(printf, format_index, first_arg)))
+# else
+# define __printf_args(format_index, first_arg)
+# endif
+#endif /* __printf_args */
+
+#ifndef __anonymous_struct_extension__
+# if defined(__GNUC__)
+# define __anonymous_struct_extension__ __extension__
+# else
+# define __anonymous_struct_extension__
+# endif
+#endif /* __anonymous_struct_extension__ */
+
+#ifndef __Wpedantic_format_voidptr
+ static __inline const void* __pure_function
+ __Wpedantic_format_voidptr(const void* ptr) {return ptr;}
+# define __Wpedantic_format_voidptr(ARG) __Wpedantic_format_voidptr(ARG)
+#endif /* __Wpedantic_format_voidptr */
+
+/*----------------------------------------------------------------------------*/
+
+#if defined(MDBX_USE_VALGRIND)
+# include
+# ifndef VALGRIND_DISABLE_ADDR_ERROR_REPORTING_IN_RANGE
+ /* LY: available since Valgrind 3.10 */
+# define VALGRIND_DISABLE_ADDR_ERROR_REPORTING_IN_RANGE(a,s)
+# define VALGRIND_ENABLE_ADDR_ERROR_REPORTING_IN_RANGE(a,s)
+# endif
+#elif !defined(RUNNING_ON_VALGRIND)
+# define VALGRIND_CREATE_MEMPOOL(h,r,z)
+# define VALGRIND_DESTROY_MEMPOOL(h)
+# define VALGRIND_MEMPOOL_TRIM(h,a,s)
+# define VALGRIND_MEMPOOL_ALLOC(h,a,s)
+# define VALGRIND_MEMPOOL_FREE(h,a)
+# define VALGRIND_MEMPOOL_CHANGE(h,a,b,s)
+# define VALGRIND_MAKE_MEM_NOACCESS(a,s)
+# define VALGRIND_MAKE_MEM_DEFINED(a,s)
+# define VALGRIND_MAKE_MEM_UNDEFINED(a,s)
+# define VALGRIND_DISABLE_ADDR_ERROR_REPORTING_IN_RANGE(a,s)
+# define VALGRIND_ENABLE_ADDR_ERROR_REPORTING_IN_RANGE(a,s)
+# define VALGRIND_CHECK_MEM_IS_ADDRESSABLE(a,s) (0)
+# define VALGRIND_CHECK_MEM_IS_DEFINED(a,s) (0)
+# define RUNNING_ON_VALGRIND (0)
+#endif /* MDBX_USE_VALGRIND */
+
+#ifdef __SANITIZE_ADDRESS__
+# include
+#elif !defined(ASAN_POISON_MEMORY_REGION)
+# define ASAN_POISON_MEMORY_REGION(addr, size) \
+ ((void)(addr), (void)(size))
+# define ASAN_UNPOISON_MEMORY_REGION(addr, size) \
+ ((void)(addr), (void)(size))
+#endif /* __SANITIZE_ADDRESS__ */
+
+/*----------------------------------------------------------------------------*/
+
+#ifndef ARRAY_LENGTH
+# ifdef __cplusplus
+ template
+ char (&__ArraySizeHelper(T (&array)[N]))[N];
+# define ARRAY_LENGTH(array) (sizeof(::__ArraySizeHelper(array)))
+# else
+# define ARRAY_LENGTH(array) (sizeof(array) / sizeof(array[0]))
+# endif
+#endif /* ARRAY_LENGTH */
+
+#ifndef ARRAY_END
+# define ARRAY_END(array) (&array[ARRAY_LENGTH(array)])
+#endif /* ARRAY_END */
+
+#ifndef STRINGIFY
+# define STRINGIFY_HELPER(x) #x
+# define STRINGIFY(x) STRINGIFY_HELPER(x)
+#endif /* STRINGIFY */
+
+#define CONCAT(a,b) a##b
+#define XCONCAT(a,b) CONCAT(a,b)
+
+#ifndef offsetof
+# define offsetof(type, member) __builtin_offsetof(type, member)
+#endif /* offsetof */
+
+#ifndef container_of
+# define container_of(ptr, type, member) \
+ ((type *)((char *)(ptr) - offsetof(type, member)))
+#endif /* container_of */
+
+#define MDBX_TETRAD(a, b, c, d) \
+ ((uint32_t)(a) << 24 | (uint32_t)(b) << 16 | (uint32_t)(c) << 8 | (d))
+
+#define MDBX_STRING_TETRAD(str) MDBX_TETRAD(str[0], str[1], str[2], str[3])
+
+#define FIXME "FIXME: " __FILE__ ", " STRINGIFY(__LINE__)
+
+#ifndef STATIC_ASSERT_MSG
+# if (defined(__STDC_VERSION__) && __STDC_VERSION__ >= 201112L) \
+ || __has_feature(c_static_assert)
+# define STATIC_ASSERT_MSG(expr, msg) _Static_assert(expr, msg)
+# elif defined(static_assert)
+# define STATIC_ASSERT_MSG(expr, msg) static_assert(expr, msg)
+# elif defined(_MSC_VER)
+# include
+# define STATIC_ASSERT_MSG(expr, msg) _STATIC_ASSERT(expr)
+# else
+# define STATIC_ASSERT_MSG(expr, msg) switch (0) {case 0:case (expr):;}
+# endif
+#endif /* STATIC_ASSERT */
+
+#ifndef STATIC_ASSERT
+# define STATIC_ASSERT(expr) STATIC_ASSERT_MSG(expr, #expr)
+#endif
+
+/* *INDENT-ON* */
+/* clang-format on */
diff --git a/contrib/db/libmdbx/src/elements/internals.h b/contrib/db/libmdbx/src/elements/internals.h
new file mode 100644
index 00000000..6aba3740
--- /dev/null
+++ b/contrib/db/libmdbx/src/elements/internals.h
@@ -0,0 +1,1367 @@
+/*
+ * Copyright 2015-2019 Leonid Yuriev
+ * and other libmdbx authors: please see AUTHORS file.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted only as authorized by the OpenLDAP
+ * Public License.
+ *
+ * A copy of this license is available in the file LICENSE in the
+ * top-level directory of the distribution or, alternatively, at
+ * . */
+
+#pragma once
+#ifdef MDBX_CONFIG_H
+#include MDBX_CONFIG_H
+#endif
+
+/* *INDENT-OFF* */
+/* clang-format off */
+
+/* In case the MDBX_DEBUG is undefined set it corresponding to NDEBUG */
+#ifndef MDBX_DEBUG
+# ifdef NDEBUG
+# define MDBX_DEBUG 0
+# else
+# define MDBX_DEBUG 1
+# endif
+#endif
+
+/* Undefine the NDEBUG if debugging is enforced by MDBX_DEBUG */
+#if MDBX_DEBUG
+# undef NDEBUG
+#endif
+
+#define MDBX_OSX_WANNA_DURABILITY 0 /* using fcntl(F_FULLFSYNC) with 5-10 times slowdown */
+#define MDBX_OSX_WANNA_SPEED 1 /* using fsync() with chance of data lost on power failure */
+#ifndef MDBX_OSX_SPEED_INSTEADOF_DURABILITY
+# define MDBX_OSX_SPEED_INSTEADOF_DURABILITY MDBX_OSX_WANNA_DURABILITY
+#endif
+
+#ifdef MDBX_ALLOY
+/* Amalgamated build */
+# define MDBX_INTERNAL_FUNC static
+# define MDBX_INTERNAL_VAR static
+#else
+/* Non-amalgamated build */
+# define MDBX_INTERNAL_FUNC
+# define MDBX_INTERNAL_VAR extern
+#endif /* MDBX_ALLOY */
+
+#ifndef MDBX_DISABLE_GNU_SOURCE
+#define MDBX_DISABLE_GNU_SOURCE 0
+#endif
+#if MDBX_DISABLE_GNU_SOURCE
+#undef _GNU_SOURCE
+#elif defined(__linux__) || defined(__gnu_linux__)
+#define _GNU_SOURCE
+#endif
+
+/*----------------------------------------------------------------------------*/
+
+/* Should be defined before any includes */
+#ifndef _FILE_OFFSET_BITS
+# define _FILE_OFFSET_BITS 64
+#endif
+
+#ifdef __APPLE__
+#define _DARWIN_C_SOURCE
+#endif
+
+#ifdef _MSC_VER
+# if _MSC_VER < 1400
+# error "Microsoft Visual C++ 8.0 (Visual Studio 2005) or later version is required"
+# endif
+# ifndef _CRT_SECURE_NO_WARNINGS
+# define _CRT_SECURE_NO_WARNINGS
+# endif
+#if _MSC_VER > 1800
+# pragma warning(disable : 4464) /* relative include path contains '..' */
+#endif
+#if _MSC_VER > 1913
+# pragma warning(disable : 5045) /* Compiler will insert Spectre mitigation... */
+#endif
+#pragma warning(disable : 4710) /* 'xyz': function not inlined */
+#pragma warning(disable : 4711) /* function 'xyz' selected for automatic inline expansion */
+#pragma warning(disable : 4201) /* nonstandard extension used : nameless struct / union */
+#pragma warning(disable : 4702) /* unreachable code */
+#pragma warning(disable : 4706) /* assignment within conditional expression */
+#pragma warning(disable : 4127) /* conditional expression is constant */
+#pragma warning(disable : 4324) /* 'xyz': structure was padded due to alignment specifier */
+#pragma warning(disable : 4310) /* cast truncates constant value */
+#pragma warning(disable : 4820) /* bytes padding added after data member for aligment */
+#pragma warning(disable : 4548) /* expression before comma has no effect; expected expression with side - effect */
+#pragma warning(disable : 4366) /* the result of the unary '&' operator may be unaligned */
+#pragma warning(disable : 4200) /* nonstandard extension used: zero-sized array in struct/union */
+#endif /* _MSC_VER (warnings) */
+
+#include "../../mdbx.h"
+#include "defs.h"
+
+#if defined(__GNUC__) && !__GNUC_PREREQ(4,2)
+ /* Actualy libmdbx was not tested with compilers older than GCC from RHEL6.
+ * But you could remove this #error and try to continue at your own risk.
+ * In such case please don't rise up an issues related ONLY to old compilers.
+ */
+# warning "libmdbx required GCC >= 4.2"
+#endif
+
+#if defined(__clang__) && !__CLANG_PREREQ(3,8)
+ /* Actualy libmdbx was not tested with CLANG older than 3.8.
+ * But you could remove this #error and try to continue at your own risk.
+ * In such case please don't rise up an issues related ONLY to old compilers.
+ */
+# warning "libmdbx required CLANG >= 3.8"
+#endif
+
+#if defined(__GLIBC__) && !__GLIBC_PREREQ(2,12)
+ /* Actualy libmdbx was not tested with something older than glibc 2.12 (from RHEL6).
+ * But you could remove this #error and try to continue at your own risk.
+ * In such case please don't rise up an issues related ONLY to old systems.
+ */
+# warning "libmdbx required at least GLIBC 2.12."
+#endif
+
+#ifdef __SANITIZE_THREAD__
+# warning "libmdbx don't compatible with ThreadSanitizer, you will get a lot of false-positive issues."
+#endif /* __SANITIZE_THREAD__ */
+
+#if __has_warning("-Wconstant-logical-operand")
+# if defined(__clang__)
+# pragma clang diagnostic ignored "-Wconstant-logical-operand"
+# elif defined(__GNUC__)
+# pragma GCC diagnostic ignored "-Wconstant-logical-operand"
+# else
+# pragma warning disable "constant-logical-operand"
+# endif
+#endif /* -Wconstant-logical-operand */
+
+#if defined(__LCC__) && (__LCC__ <= 121)
+ /* bug #2798 */
+# pragma diag_suppress alignment_reduction_ignored
+#elif defined(__ICC)
+# pragma warning(disable: 3453 1366)
+#elif __has_warning("-Walignment-reduction-ignored")
+# if defined(__clang__)
+# pragma clang diagnostic ignored "-Walignment-reduction-ignored"
+# elif defined(__GNUC__)
+# pragma GCC diagnostic ignored "-Walignment-reduction-ignored"
+# else
+# pragma warning disable "alignment-reduction-ignored"
+# endif
+#endif /* -Walignment-reduction-ignored */
+
+#include "osal.h"
+
+/* *INDENT-ON* */
+/* clang-format on */
+
+#if UINTPTR_MAX > 0xffffFFFFul || ULONG_MAX > 0xffffFFFFul
+#define MDBX_WORDBITS 64
+#else
+#define MDBX_WORDBITS 32
+#endif /* MDBX_WORDBITS */
+
+#ifndef MDBX_64BIT_ATOMIC
+#if MDBX_WORDBITS >= 64
+#define MDBX_64BIT_ATOMIC 1
+#else
+#define MDBX_64BIT_ATOMIC 0
+#endif
+#define MDBX_64BIT_ATOMIC_CONFIG "AUTO=" STRINGIFY(MDBX_64BIT_ATOMIC)
+#else
+#define MDBX_64BIT_ATOMIC_CONFIG STRINGIFY(MDBX_64BIT_ATOMIC)
+#endif /* MDBX_64BIT_ATOMIC */
+
+#ifndef MDBX_64BIT_CAS
+#if defined(ATOMIC_LLONG_LOCK_FREE)
+#if ATOMIC_LLONG_LOCK_FREE > 1
+#define MDBX_64BIT_CAS 1
+#else
+#define MDBX_64BIT_CAS 0
+#endif
+#elif defined(__GCC_ATOMIC_LLONG_LOCK_FREE)
+#if __GCC_ATOMIC_LLONG_LOCK_FREE > 1
+#define MDBX_64BIT_CAS 1
+#else
+#define MDBX_64BIT_CAS 0
+#endif
+#elif defined(__CLANG_ATOMIC_LLONG_LOCK_FREE)
+#if __CLANG_ATOMIC_LLONG_LOCK_FREE > 1
+#define MDBX_64BIT_CAS 1
+#else
+#define MDBX_64BIT_CAS 0
+#endif
+#elif defined(_MSC_VER) || defined(__APPLE__)
+#define MDBX_64BIT_CAS 1
+#else
+#define MDBX_64BIT_CAS MDBX_64BIT_ATOMIC
+#endif
+#define MDBX_64BIT_CAS_CONFIG "AUTO=" STRINGIFY(MDBX_64BIT_CAS)
+#else
+#define MDBX_64BIT_CAS_CONFIG STRINGIFY(MDBX_64BIT_CAS)
+#endif /* MDBX_64BIT_CAS */
+
+/* Some platforms define the EOWNERDEAD error code even though they
+ * don't support Robust Mutexes. Compile with -DMDBX_USE_ROBUST=0. */
+#ifndef MDBX_USE_ROBUST
+/* Howard Chu: Android currently lacks Robust Mutex support */
+#if defined(EOWNERDEAD) && !defined(__ANDROID__) && !defined(__APPLE__) && \
+ (!defined(__GLIBC__) || \
+ __GLIBC_PREREQ( \
+ 2, \
+ 10) /* LY: glibc before 2.10 has a troubles with Robust Mutex too. */ \
+ || _POSIX_C_SOURCE >= 200809L)
+#define MDBX_USE_ROBUST 1
+#else
+#define MDBX_USE_ROBUST 0
+#endif
+#define MDBX_USE_ROBUST_CONFIG "AUTO=" STRINGIFY(MDBX_USE_ROBUST)
+#else
+#define MDBX_USE_ROBUST_CONFIG STRINGIFY(MDBX_USE_ROBUST)
+#endif /* MDBX_USE_ROBUST */
+
+#ifndef MDBX_USE_OFDLOCKS
+#if defined(F_OFD_SETLK) && defined(F_OFD_SETLKW) && defined(F_OFD_GETLK) && \
+ !defined(MDBX_SAFE4QEMU)
+#define MDBX_USE_OFDLOCKS 1
+#else
+#define MDBX_USE_OFDLOCKS 0
+#endif
+#define MDBX_USE_OFDLOCKS_CONFIG "AUTO=" STRINGIFY(MDBX_USE_OFDLOCKS)
+#else
+#define MDBX_USE_OFDLOCKS_CONFIG STRINGIFY(MDBX_USE_OFDLOCKS)
+#endif /* MDBX_USE_OFDLOCKS */
+
+/* Controls checking PID against reuse DB environment after the fork() */
+#ifndef MDBX_TXN_CHECKPID
+#if defined(MADV_DONTFORK) || defined(_WIN32) || defined(_WIN64)
+/* PID check could be ommited:
+ * - on Linux when madvise(MADV_DONTFORK) is available. i.e. after the fork()
+ * mapped pages will not be available for child process.
+ * - in Windows where fork() not available. */
+#define MDBX_TXN_CHECKPID 0
+#else
+#define MDBX_TXN_CHECKPID 1
+#endif
+#define MDBX_TXN_CHECKPID_CONFIG "AUTO=" STRINGIFY(MDBX_TXN_CHECKPID)
+#else
+#define MDBX_TXN_CHECKPID_CONFIG STRINGIFY(MDBX_TXN_CHECKPID)
+#endif /* MDBX_TXN_CHECKPID */
+
+/* Controls checking transaction owner thread against misuse transactions from
+ * other threads. */
+#ifndef MDBX_TXN_CHECKOWNER
+#define MDBX_TXN_CHECKOWNER 1
+#define MDBX_TXN_CHECKOWNER_CONFIG "AUTO=" STRINGIFY(MDBX_TXN_CHECKOWNER)
+#else
+#define MDBX_TXN_CHECKOWNER_CONFIG STRINGIFY(MDBX_TXN_CHECKOWNER)
+#endif /* MDBX_TXN_CHECKOWNER */
+
+#define mdbx_sourcery_anchor XCONCAT(mdbx_sourcery_, MDBX_BUILD_SOURCERY)
+#if defined(MDBX_TOOLS)
+extern LIBMDBX_API const char *const mdbx_sourcery_anchor;
+#endif
+
+/* Does a system have battery-backed Real-Time Clock or just a fake. */
+#ifndef MDBX_TRUST_RTC
+#if defined(__linux__) || defined(__gnu_linux__) || defined(__NetBSD__) || \
+ defined(__OpenBSD__)
+#define MDBX_TRUST_RTC 0 /* a lot of embedded systems have a fake RTC */
+#else
+#define MDBX_TRUST_RTC 1
+#endif
+#define MDBX_TRUST_RTC_CONFIG "AUTO=" STRINGIFY(MDBX_TRUST_RTC)
+#else
+#define MDBX_TRUST_RTC_CONFIG STRINGIFY(MDBX_TRUST_RTC)
+#endif /* MDBX_TRUST_RTC */
+
+/*----------------------------------------------------------------------------*/
+/* Basic constants and types */
+
+/* The minimum number of keys required in a database page.
+ * Setting this to a larger value will place a smaller bound on the
+ * maximum size of a data item. Data items larger than this size will
+ * be pushed into overflow pages instead of being stored directly in
+ * the B-tree node. This value used to default to 4. With a page size
+ * of 4096 bytes that meant that any item larger than 1024 bytes would
+ * go into an overflow page. That also meant that on average 2-3KB of
+ * each overflow page was wasted space. The value cannot be lower than
+ * 2 because then there would no longer be a tree structure. With this
+ * value, items larger than 2KB will go into overflow pages, and on
+ * average only 1KB will be wasted. */
+#define MDBX_MINKEYS 2
+
+/* A stamp that identifies a file as an MDBX file.
+ * There's nothing special about this value other than that it is easily
+ * recognizable, and it will reflect any byte order mismatches. */
+#define MDBX_MAGIC UINT64_C(/* 56-bit prime */ 0x59659DBDEF4C11)
+
+/* The version number for a database's datafile format. */
+#define MDBX_DATA_VERSION 2
+/* The version number for a database's lockfile format. */
+#define MDBX_LOCK_VERSION 3
+
+/* handle for the DB used to track free pages. */
+#define FREE_DBI 0
+/* handle for the default DB. */
+#define MAIN_DBI 1
+/* Number of DBs in metapage (free and main) - also hardcoded elsewhere */
+#define CORE_DBS 2
+#define MAX_DBI (INT16_MAX - CORE_DBS)
+#if MAX_DBI != MDBX_MAX_DBI
+#error "Opps, MAX_DBI != MDBX_MAX_DBI"
+#endif
+
+/* Number of meta pages - also hardcoded elsewhere */
+#define NUM_METAS 3
+
+/* A page number in the database.
+ *
+ * MDBX uses 32 bit for page numbers. This limits database
+ * size up to 2^44 bytes, in case of 4K pages. */
+typedef uint32_t pgno_t;
+#define PRIaPGNO PRIu32
+#define MAX_PAGENO UINT32_C(0x7FFFffff)
+#define MIN_PAGENO NUM_METAS
+
+/* A transaction ID. */
+typedef uint64_t txnid_t;
+#define PRIaTXN PRIi64
+#define MIN_TXNID UINT64_C(1)
+/* LY: for testing non-atomic 64-bit txnid on 32-bit arches.
+ * #define MDBX_TXNID_STEP (UINT32_MAX / 3) */
+#ifndef MDBX_TXNID_STEP
+#if MDBX_64BIT_CAS
+#define MDBX_TXNID_STEP 1u
+#else
+#define MDBX_TXNID_STEP 2u
+#endif
+#endif /* MDBX_TXNID_STEP */
+
+/* Used for offsets within a single page.
+ * Since memory pages are typically 4 or 8KB in size, 12-13 bits,
+ * this is plenty. */
+typedef uint16_t indx_t;
+
+#define MEGABYTE ((size_t)1 << 20)
+
+/*----------------------------------------------------------------------------*/
+/* Core structures for database and shared memory (i.e. format definition) */
+#pragma pack(push, 1)
+
+typedef union mdbx_safe64 {
+ volatile uint64_t inconsistent;
+#if MDBX_64BIT_ATOMIC
+ volatile uint64_t atomic;
+#endif /* MDBX_64BIT_ATOMIC */
+ struct {
+#if __BYTE_ORDER__ == __ORDER_LITTLE_ENDIAN__
+ volatile uint32_t low;
+ volatile uint32_t high;
+#elif __BYTE_ORDER__ == __ORDER_BIG_ENDIAN__
+ volatile uint32_t high;
+ volatile uint32_t low;
+#else
+#error "FIXME: Unsupported byte order"
+#endif /* __BYTE_ORDER__ */
+ };
+} mdbx_safe64_t;
+
+#define SAFE64_INVALID_THRESHOLD UINT64_C(0xffffFFFF00000000)
+
+/* Information about a single database in the environment. */
+typedef struct MDBX_db {
+ uint16_t md_flags; /* see mdbx_dbi_open */
+ uint16_t md_depth; /* depth of this tree */
+ uint32_t md_xsize; /* also ksize for LEAF2 pages */
+ pgno_t md_root; /* the root page of this tree */
+ pgno_t md_branch_pages; /* number of internal pages */
+ pgno_t md_leaf_pages; /* number of leaf pages */
+ pgno_t md_overflow_pages; /* number of overflow pages */
+ uint64_t md_seq; /* table sequence counter */
+ uint64_t md_entries; /* number of data items */
+ uint64_t md_mod_txnid; /* txnid of last commited modification */
+} MDBX_db;
+
+/* database size-related parameters */
+typedef struct mdbx_geo_t {
+ uint16_t grow; /* datafile growth step in pages */
+ uint16_t shrink; /* datafile shrink threshold in pages */
+ pgno_t lower; /* minimal size of datafile in pages */
+ pgno_t upper; /* maximal size of datafile in pages */
+ pgno_t now; /* current size of datafile in pages */
+ pgno_t next; /* first unused page in the datafile,
+ * but actually the file may be shorter. */
+} mdbx_geo_t;
+
+/* Meta page content.
+ * A meta page is the start point for accessing a database snapshot.
+ * Pages 0-1 are meta pages. Transaction N writes meta page (N % 2). */
+typedef struct MDBX_meta {
+ /* Stamp identifying this as an MDBX file.
+ * It must be set to MDBX_MAGIC with MDBX_DATA_VERSION. */
+ uint64_t mm_magic_and_version;
+
+ /* txnid that committed this page, the first of a two-phase-update pair */
+ mdbx_safe64_t mm_txnid_a;
+
+ uint16_t mm_extra_flags; /* extra DB flags, zero (nothing) for now */
+ uint8_t mm_validator_id; /* ID of checksum and page validation method,
+ * zero (nothing) for now */
+ uint8_t mm_extra_pagehdr; /* extra bytes in the page header,
+ * zero (nothing) for now */
+
+ mdbx_geo_t mm_geo; /* database size-related parameters */
+
+ MDBX_db mm_dbs[CORE_DBS]; /* first is free space, 2nd is main db */
+ /* The size of pages used in this DB */
+#define mm_psize mm_dbs[FREE_DBI].md_xsize
+/* Any persistent environment flags, see mdbx_env */
+#define mm_flags mm_dbs[FREE_DBI].md_flags
+ mdbx_canary mm_canary;
+
+#define MDBX_DATASIGN_NONE 0u
+#define MDBX_DATASIGN_WEAK 1u
+#define SIGN_IS_WEAK(sign) ((sign) == MDBX_DATASIGN_WEAK)
+#define SIGN_IS_STEADY(sign) ((sign) > MDBX_DATASIGN_WEAK)
+#define META_IS_WEAK(meta) SIGN_IS_WEAK((meta)->mm_datasync_sign)
+#define META_IS_STEADY(meta) SIGN_IS_STEADY((meta)->mm_datasync_sign)
+ volatile uint64_t mm_datasync_sign;
+
+ /* txnid that committed this page, the second of a two-phase-update pair */
+ mdbx_safe64_t mm_txnid_b;
+
+ /* Number of non-meta pages which were put in GC after COW. May be 0 in case
+ * DB was previously handled by libmdbx without corresponding feature.
+ * This value in couple with mr_snapshot_pages_retired allows fast estimation
+ * of "how much reader is restraining GC recycling". */
+ uint64_t mm_pages_retired;
+} MDBX_meta;
+
+/* Common header for all page types. The page type depends on mp_flags.
+ *
+ * P_BRANCH and P_LEAF pages have unsorted 'MDBX_node's at the end, with
+ * sorted mp_ptrs[] entries referring to them. Exception: P_LEAF2 pages
+ * omit mp_ptrs and pack sorted MDBX_DUPFIXED values after the page header.
+ *
+ * P_OVERFLOW records occupy one or more contiguous pages where only the
+ * first has a page header. They hold the real data of F_BIGDATA nodes.
+ *
+ * P_SUBP sub-pages are small leaf "pages" with duplicate data.
+ * A node with flag F_DUPDATA but not F_SUBDATA contains a sub-page.
+ * (Duplicate data can also go in sub-databases, which use normal pages.)
+ *
+ * P_META pages contain MDBX_meta, the start point of an MDBX snapshot.
+ *
+ * Each non-metapage up to MDBX_meta.mm_last_pg is reachable exactly once
+ * in the snapshot: Either used by a database or listed in a GC record. */
+typedef struct MDBX_page {
+ union {
+ struct MDBX_page *mp_next; /* for in-memory list of freed pages */
+ uint64_t mp_validator; /* checksum of page content or a txnid during
+ * which the page has been updated */
+ };
+ uint16_t mp_leaf2_ksize; /* key size if this is a LEAF2 page */
+#define P_BRANCH 0x01 /* branch page */
+#define P_LEAF 0x02 /* leaf page */
+#define P_OVERFLOW 0x04 /* overflow page */
+#define P_META 0x08 /* meta page */
+#define P_DIRTY 0x10 /* dirty page, also set for P_SUBP pages */
+#define P_LEAF2 0x20 /* for MDBX_DUPFIXED records */
+#define P_SUBP 0x40 /* for MDBX_DUPSORT sub-pages */
+#define P_LOOSE 0x4000 /* page was dirtied then freed, can be reused */
+#define P_KEEP 0x8000 /* leave this page alone during spill */
+ uint16_t mp_flags;
+ union {
+ struct {
+ indx_t mp_lower; /* lower bound of free space */
+ indx_t mp_upper; /* upper bound of free space */
+ };
+ uint32_t mp_pages; /* number of overflow pages */
+ };
+ pgno_t mp_pgno; /* page number */
+
+ /* dynamic size */
+ indx_t mp_ptrs[/* C99 */];
+} MDBX_page;
+
+/* Size of the page header, excluding dynamic data at the end */
+#define PAGEHDRSZ ((unsigned)offsetof(MDBX_page, mp_ptrs))
+
+#pragma pack(pop)
+
+/* Reader Lock Table
+ *
+ * Readers don't acquire any locks for their data access. Instead, they
+ * simply record their transaction ID in the reader table. The reader
+ * mutex is needed just to find an empty slot in the reader table. The
+ * slot's address is saved in thread-specific data so that subsequent
+ * read transactions started by the same thread need no further locking to
+ * proceed.
+ *
+ * If MDBX_NOTLS is set, the slot address is not saved in thread-specific data.
+ * No reader table is used if the database is on a read-only filesystem.
+ *
+ * Since the database uses multi-version concurrency control, readers don't
+ * actually need any locking. This table is used to keep track of which
+ * readers are using data from which old transactions, so that we'll know
+ * when a particular old transaction is no longer in use. Old transactions
+ * that have discarded any data pages can then have those pages reclaimed
+ * for use by a later write transaction.
+ *
+ * The lock table is constructed such that reader slots are aligned with the
+ * processor's cache line size. Any slot is only ever used by one thread.
+ * This alignment guarantees that there will be no contention or cache
+ * thrashing as threads update their own slot info, and also eliminates
+ * any need for locking when accessing a slot.
+ *
+ * A writer thread will scan every slot in the table to determine the oldest
+ * outstanding reader transaction. Any freed pages older than this will be
+ * reclaimed by the writer. The writer doesn't use any locks when scanning
+ * this table. This means that there's no guarantee that the writer will
+ * see the most up-to-date reader info, but that's not required for correct
+ * operation - all we need is to know the upper bound on the oldest reader,
+ * we don't care at all about the newest reader. So the only consequence of
+ * reading stale information here is that old pages might hang around a
+ * while longer before being reclaimed. That's actually good anyway, because
+ * the longer we delay reclaiming old pages, the more likely it is that a
+ * string of contiguous pages can be found after coalescing old pages from
+ * many old transactions together. */
+
+/* The actual reader record, with cacheline padding. */
+typedef struct MDBX_reader {
+ /* Current Transaction ID when this transaction began, or (txnid_t)-1.
+ * Multiple readers that start at the same time will probably have the
+ * same ID here. Again, it's not important to exclude them from
+ * anything; all we need to know is which version of the DB they
+ * started from so we can avoid overwriting any data used in that
+ * particular version. */
+ mdbx_safe64_t /* txnid_t */ mr_txnid;
+
+ /* The information we store in a single slot of the reader table.
+ * In addition to a transaction ID, we also record the process and
+ * thread ID that owns a slot, so that we can detect stale information,
+ * e.g. threads or processes that went away without cleaning up.
+ *
+ * NOTE: We currently don't check for stale records.
+ * We simply re-init the table when we know that we're the only process
+ * opening the lock file. */
+
+ /* The thread ID of the thread owning this txn. */
+#if MDBX_WORDBITS >= 64
+ volatile uint64_t mr_tid;
+#else
+ volatile uint32_t mr_tid;
+ volatile uint32_t mr_aba_curer; /* CSN to resolve ABA_problems on 32-bit arch,
+ unused for now */
+#endif
+ /* The process ID of the process owning this reader txn. */
+ volatile uint32_t mr_pid;
+
+ /* The number of pages used in the reader's MVCC snapshot,
+ * i.e. the value of meta->mm_geo.next and txn->mt_next_pgno */
+ volatile pgno_t mr_snapshot_pages_used;
+ /* Number of retired pages at the time this reader starts transaction. So,
+ * at any time the difference mm_pages_retired - mr_snapshot_pages_retired
+ * will give the number of pages which this reader restraining from reuse. */
+ volatile uint64_t mr_snapshot_pages_retired;
+} MDBX_reader;
+
+/* The header for the reader table (a memory-mapped lock file). */
+typedef struct MDBX_lockinfo {
+ /* Stamp identifying this as an MDBX file.
+ * It must be set to MDBX_MAGIC with with MDBX_LOCK_VERSION. */
+ uint64_t mti_magic_and_version;
+
+ /* Format of this lock file. Must be set to MDBX_LOCK_FORMAT. */
+ uint32_t mti_os_and_format;
+
+ /* Flags which environment was opened. */
+ volatile uint32_t mti_envmode;
+
+ /* Threshold of un-synced-with-disk pages for auto-sync feature,
+ * zero means no-threshold, i.e. auto-sync is disabled. */
+ volatile pgno_t mti_autosync_threshold;
+
+ /* Low 32-bit of txnid with which meta-pages was synced,
+ * i.e. for sync-polling in the MDBX_NOMETASYNC mode. */
+ volatile uint32_t mti_meta_sync_txnid;
+
+ /* Period for timed auto-sync feature, i.e. at the every steady checkpoint
+ * the mti_unsynced_timeout sets to the current_time + mti_autosync_period.
+ * The time value is represented in a suitable system-dependent form, for
+ * example clock_gettime(CLOCK_BOOTTIME) or clock_gettime(CLOCK_MONOTONIC).
+ * Zero means timed auto-sync is disabled. */
+ volatile uint64_t mti_autosync_period;
+
+ /* Marker to distinguish uniqueness of DB/CLK.*/
+ volatile uint64_t mti_bait_uniqueness;
+
+ /* The analogue /proc/sys/kernel/random/boot_id or similar to determine
+ * whether the system was rebooted after the last use of the database files.
+ * If there was no reboot, but there is no need to rollback to the last
+ * steady sync point. Zeros mean that no relevant information is available
+ * from the system. */
+ volatile bin128_t mti_bootid;
+
+ alignas(MDBX_CACHELINE_SIZE) /* cacheline ---------------------------------*/
+#ifdef MDBX_OSAL_LOCK
+ /* Mutex protecting write-txn. */
+ MDBX_OSAL_LOCK mti_wmutex;
+#endif
+
+ volatile txnid_t mti_oldest_reader;
+
+ /* Timestamp of the last steady sync. Value is represented in a suitable
+ * system-dependent form, for example clock_gettime(CLOCK_BOOTTIME) or
+ * clock_gettime(CLOCK_MONOTONIC). */
+ volatile uint64_t mti_sync_timestamp;
+
+ /* Number un-synced-with-disk pages for auto-sync feature. */
+ volatile pgno_t mti_unsynced_pages;
+
+ /* Number of page which was discarded last time by madvise(MADV_FREE). */
+ volatile pgno_t mti_discarded_tail;
+
+ /* Timestamp of the last readers check. */
+ volatile uint64_t mti_reader_check_timestamp;
+
+ alignas(MDBX_CACHELINE_SIZE) /* cacheline ---------------------------------*/
+
+#ifdef MDBX_OSAL_LOCK
+ /* Mutex protecting readers registration access to this table. */
+ MDBX_OSAL_LOCK mti_rmutex;
+#endif
+
+ /* The number of slots that have been used in the reader table.
+ * This always records the maximum count, it is not decremented
+ * when readers release their slots. */
+ volatile unsigned mti_numreaders;
+ volatile unsigned mti_readers_refresh_flag;
+
+ alignas(MDBX_CACHELINE_SIZE) /* cacheline ---------------------------------*/
+ MDBX_reader mti_readers[/* C99 */];
+} MDBX_lockinfo;
+
+/* Lockfile format signature: version, features and field layout */
+#define MDBX_LOCK_FORMAT \
+ (MDBX_OSAL_LOCK_SIGN * 27733 + (unsigned)sizeof(MDBX_reader) * 13 + \
+ (unsigned)offsetof(MDBX_reader, mr_snapshot_pages_used) * 251 + \
+ (unsigned)offsetof(MDBX_lockinfo, mti_oldest_reader) * 83 + \
+ (unsigned)offsetof(MDBX_lockinfo, mti_numreaders) * 37 + \
+ (unsigned)offsetof(MDBX_lockinfo, mti_readers) * 29)
+
+#define MDBX_DATA_MAGIC ((MDBX_MAGIC << 8) + MDBX_DATA_VERSION)
+#define MDBX_DATA_MAGIC_DEVEL ((MDBX_MAGIC << 8) + 255)
+
+#define MDBX_LOCK_MAGIC ((MDBX_MAGIC << 8) + MDBX_LOCK_VERSION)
+
+#ifndef MDBX_ASSUME_MALLOC_OVERHEAD
+#define MDBX_ASSUME_MALLOC_OVERHEAD (sizeof(void *) * 2u)
+#endif /* MDBX_ASSUME_MALLOC_OVERHEAD */
+
+/* The maximum size of a database page.
+ *
+ * It is 64K, but value-PAGEHDRSZ must fit in MDBX_page.mp_upper.
+ *
+ * MDBX will use database pages < OS pages if needed.
+ * That causes more I/O in write transactions: The OS must
+ * know (read) the whole page before writing a partial page.
+ *
+ * Note that we don't currently support Huge pages. On Linux,
+ * regular data files cannot use Huge pages, and in general
+ * Huge pages aren't actually pageable. We rely on the OS
+ * demand-pager to read our data and page it out when memory
+ * pressure from other processes is high. So until OSs have
+ * actual paging support for Huge pages, they're not viable. */
+#define MAX_PAGESIZE MDBX_MAX_PAGESIZE
+#define MIN_PAGESIZE MDBX_MIN_PAGESIZE
+
+#define MIN_MAPSIZE (MIN_PAGESIZE * MIN_PAGENO)
+#if defined(_WIN32) || defined(_WIN64)
+#define MAX_MAPSIZE32 UINT32_C(0x38000000)
+#else
+#define MAX_MAPSIZE32 UINT32_C(0x7ff80000)
+#endif
+#define MAX_MAPSIZE64 (MAX_PAGENO * (uint64_t)MAX_PAGESIZE)
+
+#if MDBX_WORDBITS >= 64
+#define MAX_MAPSIZE MAX_MAPSIZE64
+#define MDBX_READERS_LIMIT \
+ ((65536 - sizeof(MDBX_lockinfo)) / sizeof(MDBX_reader))
+#else
+#define MDBX_READERS_LIMIT 1024
+#define MAX_MAPSIZE MAX_MAPSIZE32
+#endif /* MDBX_WORDBITS */
+
+/*----------------------------------------------------------------------------*/
+/* Two kind lists of pages (aka PNL) */
+
+/* An PNL is an Page Number List, a sorted array of IDs. The first element of
+ * the array is a counter for how many actual page-numbers are in the list.
+ * PNLs are sorted in descending order, this allow cut off a page with lowest
+ * pgno (at the tail) just truncating the list */
+#define MDBX_PNL_ASCENDING 0
+typedef pgno_t *MDBX_PNL;
+
+#if MDBX_PNL_ASCENDING
+#define MDBX_PNL_ORDERED(first, last) ((first) < (last))
+#define MDBX_PNL_DISORDERED(first, last) ((first) >= (last))
+#else
+#define MDBX_PNL_ORDERED(first, last) ((first) > (last))
+#define MDBX_PNL_DISORDERED(first, last) ((first) <= (last))
+#endif
+
+/* List of txnid, only for MDBX_txn.tw.lifo_reclaimed */
+typedef txnid_t *MDBX_TXL;
+
+/* An Dirty-Page list item is an pgno/pointer pair. */
+typedef union MDBX_DP {
+ struct {
+ pgno_t pgno;
+ MDBX_page *ptr;
+ };
+ struct {
+ unsigned sorted;
+ unsigned length;
+ };
+} MDBX_DP;
+
+/* An DPL (dirty-page list) is a sorted array of MDBX_DPs.
+ * The first element's length member is a count of how many actual
+ * elements are in the array. */
+typedef MDBX_DP *MDBX_DPL;
+
+/* PNL sizes - likely should be even bigger */
+#define MDBX_PNL_GRANULATE 1024
+#define MDBX_PNL_INITIAL \
+ (MDBX_PNL_GRANULATE - 2 - MDBX_ASSUME_MALLOC_OVERHEAD / sizeof(pgno_t))
+#define MDBX_PNL_MAX \
+ ((1u << 24) - 2 - MDBX_ASSUME_MALLOC_OVERHEAD / sizeof(pgno_t))
+#define MDBX_DPL_TXNFULL (MDBX_PNL_MAX / 4)
+
+#define MDBX_TXL_GRANULATE 32
+#define MDBX_TXL_INITIAL \
+ (MDBX_TXL_GRANULATE - 2 - MDBX_ASSUME_MALLOC_OVERHEAD / sizeof(txnid_t))
+#define MDBX_TXL_MAX \
+ ((1u << 17) - 2 - MDBX_ASSUME_MALLOC_OVERHEAD / sizeof(txnid_t))
+
+#define MDBX_PNL_ALLOCLEN(pl) ((pl)[-1])
+#define MDBX_PNL_SIZE(pl) ((pl)[0])
+#define MDBX_PNL_FIRST(pl) ((pl)[1])
+#define MDBX_PNL_LAST(pl) ((pl)[MDBX_PNL_SIZE(pl)])
+#define MDBX_PNL_BEGIN(pl) (&(pl)[1])
+#define MDBX_PNL_END(pl) (&(pl)[MDBX_PNL_SIZE(pl) + 1])
+
+#if MDBX_PNL_ASCENDING
+#define MDBX_PNL_LEAST(pl) MDBX_PNL_FIRST(pl)
+#define MDBX_PNL_MOST(pl) MDBX_PNL_LAST(pl)
+#else
+#define MDBX_PNL_LEAST(pl) MDBX_PNL_LAST(pl)
+#define MDBX_PNL_MOST(pl) MDBX_PNL_FIRST(pl)
+#endif
+
+#define MDBX_PNL_SIZEOF(pl) ((MDBX_PNL_SIZE(pl) + 1) * sizeof(pgno_t))
+#define MDBX_PNL_IS_EMPTY(pl) (MDBX_PNL_SIZE(pl) == 0)
+
+/*----------------------------------------------------------------------------*/
+/* Internal structures */
+
+/* Auxiliary DB info.
+ * The information here is mostly static/read-only. There is
+ * only a single copy of this record in the environment. */
+typedef struct MDBX_dbx {
+ MDBX_val md_name; /* name of the database */
+ MDBX_cmp_func *md_cmp; /* function for comparing keys */
+ MDBX_cmp_func *md_dcmp; /* function for comparing data items */
+} MDBX_dbx;
+
+/* A database transaction.
+ * Every operation requires a transaction handle. */
+struct MDBX_txn {
+#define MDBX_MT_SIGNATURE UINT32_C(0x93D53A31)
+ size_t mt_signature;
+ MDBX_txn *mt_parent; /* parent of a nested txn */
+ /* Nested txn under this txn, set together with flag MDBX_TXN_HAS_CHILD */
+ MDBX_txn *mt_child;
+ mdbx_geo_t mt_geo;
+ /* next unallocated page */
+#define mt_next_pgno mt_geo.next
+ /* corresponding to the current size of datafile */
+#define mt_end_pgno mt_geo.now
+
+ /* Transaction Flags */
+ /* mdbx_txn_begin() flags */
+#define MDBX_TXN_BEGIN_FLAGS \
+ (MDBX_NOMETASYNC | MDBX_NOSYNC | MDBX_MAPASYNC | MDBX_RDONLY | MDBX_TRYTXN)
+ /* internal txn flags */
+#define MDBX_TXN_FINISHED 0x01 /* txn is finished or never began */
+#define MDBX_TXN_ERROR 0x02 /* txn is unusable after an error */
+#define MDBX_TXN_DIRTY 0x04 /* must write, even if dirty list is empty */
+#define MDBX_TXN_SPILLS 0x08 /* txn or a parent has spilled pages */
+#define MDBX_TXN_HAS_CHILD 0x10 /* txn has an MDBX_txn.mt_child */
+ /* most operations on the txn are currently illegal */
+#define MDBX_TXN_BLOCKED \
+ (MDBX_TXN_FINISHED | MDBX_TXN_ERROR | MDBX_TXN_HAS_CHILD)
+ unsigned mt_flags;
+ /* The ID of this transaction. IDs are integers incrementing from 1.
+ * Only committed write transactions increment the ID. If a transaction
+ * aborts, the ID may be re-used by the next writer. */
+ txnid_t mt_txnid;
+ MDBX_env *mt_env; /* the DB environment */
+ /* Array of records for each DB known in the environment. */
+ MDBX_dbx *mt_dbxs;
+ /* Array of MDBX_db records for each known DB */
+ MDBX_db *mt_dbs;
+ /* Array of sequence numbers for each DB handle */
+ unsigned *mt_dbiseqs;
+
+ /* Transaction DB Flags */
+#define DB_DIRTY MDBX_TBL_DIRTY /* DB was written in this txn */
+#define DB_STALE MDBX_TBL_STALE /* Named-DB record is older than txnID */
+#define DB_FRESH MDBX_TBL_FRESH /* Named-DB handle opened in this txn */
+#define DB_CREAT MDBX_TBL_CREAT /* Named-DB handle created in this txn */
+#define DB_VALID 0x10 /* DB handle is valid, see also MDBX_VALID */
+#define DB_USRVALID 0x20 /* As DB_VALID, but not set for FREE_DBI */
+#define DB_DUPDATA 0x40 /* DB is MDBX_DUPSORT data */
+#define DB_AUDITED 0x80 /* Internal flag for accounting during audit */
+ /* In write txns, array of cursors for each DB */
+ MDBX_cursor **mt_cursors;
+ /* Array of flags for each DB */
+ uint8_t *mt_dbflags;
+ /* Number of DB records in use, or 0 when the txn is finished.
+ * This number only ever increments until the txn finishes; we
+ * don't decrement it when individual DB handles are closed. */
+ MDBX_dbi mt_numdbs;
+ size_t mt_owner; /* thread ID that owns this transaction */
+ mdbx_canary mt_canary;
+
+ union {
+ struct {
+ /* For read txns: This thread/txn's reader table slot, or NULL. */
+ MDBX_reader *reader;
+ } to;
+ struct {
+ pgno_t *reclaimed_pglist; /* Reclaimed GC pages */
+ txnid_t last_reclaimed; /* ID of last used record */
+ pgno_t loose_refund_wl /* FIXME: describe */;
+ /* dirtylist room: Dirty array size - dirty pages visible to this txn.
+ * Includes ancestor txns' dirty pages not hidden by other txns'
+ * dirty/spilled pages. Thus commit(nested txn) has room to merge
+ * dirtylist into mt_parent after freeing hidden mt_parent pages. */
+ unsigned dirtyroom;
+ /* For write txns: Modified pages. Sorted when not MDBX_WRITEMAP. */
+ MDBX_DPL dirtylist;
+ /* The list of reclaimed txns from GC */
+ MDBX_TXL lifo_reclaimed;
+ /* The list of pages that became unused during this transaction. */
+ MDBX_PNL retired_pages;
+ /* The list of loose pages that became unused and may be reused
+ * in this transaction, linked through `mp_next`. */
+ MDBX_page *loose_pages;
+ /* Number of loose pages (tw.loose_pages) */
+ unsigned loose_count;
+ /* Number of retired to parent pages (tw.retired2parent_pages) */
+ unsigned retired2parent_count;
+ /* The list of parent's txn dirty pages that retired (became unused)
+ * in this transaction, linked through `mp_next`. */
+ MDBX_page *retired2parent_pages;
+ /* The sorted list of dirty pages we temporarily wrote to disk
+ * because the dirty list was full. page numbers in here are
+ * shifted left by 1, deleted slots have the LSB set. */
+ MDBX_PNL spill_pages;
+ } tw;
+ };
+};
+
+/* Enough space for 2^32 nodes with minimum of 2 keys per node. I.e., plenty.
+ * At 4 keys per node, enough for 2^64 nodes, so there's probably no need to
+ * raise this on a 64 bit machine. */
+#if MDBX_WORDBITS >= 64
+#define CURSOR_STACK 28
+#else
+#define CURSOR_STACK 20
+#endif
+
+struct MDBX_xcursor;
+
+/* Cursors are used for all DB operations.
+ * A cursor holds a path of (page pointer, key index) from the DB
+ * root to a position in the DB, plus other state. MDBX_DUPSORT
+ * cursors include an xcursor to the current data item. Write txns
+ * track their cursors and keep them up to date when data moves.
+ * Exception: An xcursor's pointer to a P_SUBP page can be stale.
+ * (A node with F_DUPDATA but no F_SUBDATA contains a subpage). */
+struct MDBX_cursor {
+#define MDBX_MC_SIGNATURE UINT32_C(0xFE05D5B1)
+#define MDBX_MC_READY4CLOSE UINT32_C(0x2817A047)
+#define MDBX_MC_WAIT4EOT UINT32_C(0x90E297A7)
+ uint32_t mc_signature;
+ /* The database handle this cursor operates on */
+ MDBX_dbi mc_dbi;
+ /* Next cursor on this DB in this txn */
+ MDBX_cursor *mc_next;
+ /* Backup of the original cursor if this cursor is a shadow */
+ MDBX_cursor *mc_backup;
+ /* Context used for databases with MDBX_DUPSORT, otherwise NULL */
+ struct MDBX_xcursor *mc_xcursor;
+ /* The transaction that owns this cursor */
+ MDBX_txn *mc_txn;
+ /* The database record for this cursor */
+ MDBX_db *mc_db;
+ /* The database auxiliary record for this cursor */
+ MDBX_dbx *mc_dbx;
+ /* The mt_dbflag for this database */
+ uint8_t *mc_dbflag;
+ uint16_t mc_snum; /* number of pushed pages */
+ uint16_t mc_top; /* index of top page, normally mc_snum-1 */
+ /* Cursor state flags. */
+#define C_INITIALIZED 0x01 /* cursor has been initialized and is valid */
+#define C_EOF 0x02 /* No more data */
+#define C_SUB 0x04 /* Cursor is a sub-cursor */
+#define C_DEL 0x08 /* last op was a cursor_del */
+#define C_UNTRACK 0x10 /* Un-track cursor when closing */
+#define C_RECLAIMING 0x20 /* GC lookup is prohibited */
+#define C_GCFREEZE 0x40 /* reclaimed_pglist must not be updated */
+ unsigned mc_flags; /* see mdbx_cursor */
+ MDBX_page *mc_pg[CURSOR_STACK]; /* stack of pushed pages */
+ indx_t mc_ki[CURSOR_STACK]; /* stack of page indices */
+};
+
+/* Context for sorted-dup records.
+ * We could have gone to a fully recursive design, with arbitrarily
+ * deep nesting of sub-databases. But for now we only handle these
+ * levels - main DB, optional sub-DB, sorted-duplicate DB. */
+typedef struct MDBX_xcursor {
+ /* A sub-cursor for traversing the Dup DB */
+ MDBX_cursor mx_cursor;
+ /* The database record for this Dup DB */
+ MDBX_db mx_db;
+ /* The auxiliary DB record for this Dup DB */
+ MDBX_dbx mx_dbx;
+ /* The mt_dbflag for this Dup DB */
+ uint8_t mx_dbflag;
+} MDBX_xcursor;
+
+typedef struct MDBX_cursor_couple {
+ MDBX_cursor outer;
+ MDBX_xcursor inner;
+} MDBX_cursor_couple;
+
+/* The database environment. */
+struct MDBX_env {
+#define MDBX_ME_SIGNATURE UINT32_C(0x9A899641)
+ size_t me_signature;
+ mdbx_mmap_t me_dxb_mmap; /* The main data file */
+#define me_map me_dxb_mmap.dxb
+#define me_fd me_dxb_mmap.fd
+ mdbx_mmap_t me_lck_mmap; /* The lock file */
+#define me_lfd me_lck_mmap.fd
+#define me_lck me_lck_mmap.lck
+
+ /* Failed to update the meta page. Probably an I/O error. */
+#define MDBX_FATAL_ERROR UINT32_C(0x80000000)
+ /* Additional flag for mdbx_sync_locked() */
+#define MDBX_SHRINK_ALLOWED UINT32_C(0x40000000)
+ /* Some fields are initialized. */
+#define MDBX_ENV_ACTIVE UINT32_C(0x20000000)
+ /* me_txkey is set */
+#define MDBX_ENV_TXKEY UINT32_C(0x10000000)
+ uint32_t me_flags; /* see mdbx_env */
+ unsigned me_psize; /* DB page size, inited from me_os_psize */
+ unsigned me_psize2log; /* log2 of DB page size */
+ unsigned me_os_psize; /* OS page size, from mdbx_syspagesize() */
+ unsigned me_maxreaders; /* size of the reader table */
+ mdbx_fastmutex_t me_dbi_lock;
+ MDBX_dbi me_numdbs; /* number of DBs opened */
+ MDBX_dbi me_maxdbs; /* size of the DB table */
+ uint32_t me_pid; /* process ID of this env */
+ mdbx_thread_key_t me_txkey; /* thread-key for readers */
+ char *me_path; /* path to the DB files */
+ void *me_pbuf; /* scratch area for DUPSORT put() */
+ MDBX_txn *me_txn; /* current write transaction */
+ MDBX_txn *me_txn0; /* prealloc'd write transaction */
+#ifdef MDBX_OSAL_LOCK
+ MDBX_OSAL_LOCK *me_wmutex; /* write-txn mutex */
+#endif
+ MDBX_dbx *me_dbxs; /* array of static DB info */
+ uint16_t *me_dbflags; /* array of flags from MDBX_db.md_flags */
+ unsigned *me_dbiseqs; /* array of dbi sequence numbers */
+ volatile txnid_t *me_oldest; /* ID of oldest reader last time we looked */
+ MDBX_page *me_dpages; /* list of malloc'd blocks for re-use */
+ /* PNL of pages that became unused in a write txn */
+ MDBX_PNL me_retired_pages;
+ /* MDBX_DP of pages written during a write txn. Length MDBX_DPL_TXNFULL. */
+ MDBX_DPL me_dirtylist;
+ /* Number of freelist items that can fit in a single overflow page */
+ unsigned me_maxgc_ov1page;
+ /* Max size of a node on a page */
+ unsigned me_nodemax;
+ unsigned me_maxkey_limit; /* max size of a key */
+ uint32_t me_live_reader; /* have liveness lock in reader table */
+ void *me_userctx; /* User-settable context */
+ volatile uint64_t *me_sync_timestamp;
+ volatile uint64_t *me_autosync_period;
+ volatile pgno_t *me_unsynced_pages;
+ volatile pgno_t *me_autosync_threshold;
+ volatile pgno_t *me_discarded_tail;
+ volatile uint32_t *me_meta_sync_txnid;
+ MDBX_oom_func *me_oom_func; /* Callback for kicking laggard readers */
+ struct {
+#ifdef MDBX_OSAL_LOCK
+ MDBX_OSAL_LOCK wmutex;
+#endif
+ txnid_t oldest;
+ uint64_t sync_timestamp;
+ uint64_t autosync_period;
+ pgno_t autosync_pending;
+ pgno_t autosync_threshold;
+ pgno_t discarded_tail;
+ uint32_t meta_sync_txnid;
+ } me_lckless_stub;
+#if MDBX_DEBUG
+ MDBX_assert_func *me_assert_func; /* Callback for assertion failures */
+#endif
+#ifdef MDBX_USE_VALGRIND
+ int me_valgrind_handle;
+#endif
+#if defined(MDBX_USE_VALGRIND) || defined(__SANITIZE_ADDRESS__)
+ pgno_t me_poison_edge;
+#endif
+ MDBX_env *me_lcklist_next;
+
+ /* struct me_dbgeo used for accepting db-geo params from user for the new
+ * database creation, i.e. when mdbx_env_set_geometry() was called before
+ * mdbx_env_open(). */
+ struct {
+ size_t lower; /* minimal size of datafile */
+ size_t upper; /* maximal size of datafile */
+ size_t now; /* current size of datafile */
+ size_t grow; /* step to grow datafile */
+ size_t shrink; /* threshold to shrink datafile */
+ } me_dbgeo;
+
+#if defined(_WIN32) || defined(_WIN64)
+ MDBX_srwlock me_remap_guard;
+ /* Workaround for LockFileEx and WriteFile multithread bug */
+ CRITICAL_SECTION me_windowsbug_lock;
+#else
+ mdbx_fastmutex_t me_remap_guard;
+#endif
+};
+
+/*----------------------------------------------------------------------------*/
+/* Debug and Logging stuff */
+
+#define MDBX_RUNTIME_FLAGS_INIT \
+ ((MDBX_DEBUG) > 0) * MDBX_DBG_ASSERT + ((MDBX_DEBUG) > 1) * MDBX_DBG_AUDIT
+
+#ifndef mdbx_runtime_flags /* avoid override from tools */
+MDBX_INTERNAL_VAR uint8_t mdbx_runtime_flags;
+#endif
+#ifndef mdbx_runtime_flags /* avoid override from tools */
+MDBX_INTERNAL_VAR uint8_t mdbx_loglevel;
+#endif
+MDBX_INTERNAL_VAR MDBX_debug_func *mdbx_debug_logger;
+
+MDBX_INTERNAL_FUNC void mdbx_debug_log(int type, const char *function, int line,
+ const char *fmt, ...)
+ __printf_args(4, 5);
+
+MDBX_INTERNAL_FUNC void mdbx_panic(const char *fmt, ...) __printf_args(1, 2);
+
+#if MDBX_DEBUG
+
+#define mdbx_assert_enabled() unlikely(mdbx_runtime_flags &MDBX_DBG_ASSERT)
+
+#define mdbx_audit_enabled() unlikely(mdbx_runtime_flags &MDBX_DBG_AUDIT)
+
+#ifdef MDBX_LOGLEVEL_BUILD
+#define mdbx_log_enabled(msg) \
+ (msg <= MDBX_LOGLEVEL_BUILD && unlikely(msg <= mdbx_loglevel))
+#else
+#define mdbx_log_enabled(msg) unlikely(msg <= mdbx_loglevel)
+#endif /* MDBX_LOGLEVEL_BUILD */
+
+#else /* MDBX_DEBUG */
+
+#define mdbx_audit_enabled() (0)
+
+#if !defined(NDEBUG) || defined(MDBX_FORCE_ASSERT)
+#define mdbx_assert_enabled() (1)
+#else
+#define mdbx_assert_enabled() (0)
+#endif /* NDEBUG */
+
+#ifdef MDBX_LOGLEVEL_BUILD
+#define mdbx_log_enabled(msg) (msg <= MDBX_LOGLEVEL_BUILD)
+#else
+#define mdbx_log_enabled(msg) (0)
+#endif /* MDBX_LOGLEVEL_BUILD */
+
+#endif /* MDBX_DEBUG */
+
+MDBX_INTERNAL_FUNC void mdbx_assert_fail(const MDBX_env *env, const char *msg,
+ const char *func, int line);
+
+#define mdbx_debug_extra(fmt, ...) \
+ do { \
+ if (mdbx_log_enabled(MDBX_LOG_EXTRA)) \
+ mdbx_debug_log(MDBX_LOG_EXTRA, __func__, __LINE__, fmt, __VA_ARGS__); \
+ } while (0)
+
+#define mdbx_debug_extra_print(fmt, ...) \
+ do { \
+ if (mdbx_log_enabled(MDBX_LOG_EXTRA)) \
+ mdbx_debug_log(MDBX_LOG_EXTRA, NULL, 0, fmt, __VA_ARGS__); \
+ } while (0)
+
+#define mdbx_trace(fmt, ...) \
+ do { \
+ if (mdbx_log_enabled(MDBX_LOG_TRACE)) \
+ mdbx_debug_log(MDBX_LOG_TRACE, __func__, __LINE__, fmt "\n", \
+ __VA_ARGS__); \
+ } while (0)
+
+#define mdbx_debug(fmt, ...) \
+ do { \
+ if (mdbx_log_enabled(MDBX_LOG_DEBUG)) \
+ mdbx_debug_log(MDBX_LOG_DEBUG, __func__, __LINE__, fmt "\n", \
+ __VA_ARGS__); \
+ } while (0)
+
+#define mdbx_debug_print(fmt, ...) \
+ do { \
+ if (mdbx_log_enabled(MDBX_LOG_DEBUG)) \
+ mdbx_debug_log(MDBX_LOG_DEBUG, NULL, 0, fmt, __VA_ARGS__); \
+ } while (0)
+
+#define mdbx_verbose(fmt, ...) \
+ do { \
+ if (mdbx_log_enabled(MDBX_LOG_VERBOSE)) \
+ mdbx_debug_log(MDBX_LOG_VERBOSE, __func__, __LINE__, fmt "\n", \
+ __VA_ARGS__); \
+ } while (0)
+
+#define mdbx_notice(fmt, ...) \
+ do { \
+ if (mdbx_log_enabled(MDBX_LOG_NOTICE)) \
+ mdbx_debug_log(MDBX_LOG_NOTICE, __func__, __LINE__, fmt "\n", \
+ __VA_ARGS__); \
+ } while (0)
+
+#define mdbx_warning(fmt, ...) \
+ do { \
+ if (mdbx_log_enabled(MDBX_LOG_WARN)) \
+ mdbx_debug_log(MDBX_LOG_WARN, __func__, __LINE__, fmt "\n", \
+ __VA_ARGS__); \
+ } while (0)
+
+#define mdbx_error(fmt, ...) \
+ do { \
+ if (mdbx_log_enabled(MDBX_LOG_ERROR)) \
+ mdbx_debug_log(MDBX_LOG_ERROR, __func__, __LINE__, fmt "\n", \
+ __VA_ARGS__); \
+ } while (0)
+
+#define mdbx_fatal(fmt, ...) \
+ mdbx_debug_log(MDBX_LOG_FATAL, __func__, __LINE__, fmt "\n", __VA_ARGS__);
+
+#define mdbx_ensure_msg(env, expr, msg) \
+ do { \
+ if (unlikely(!(expr))) \
+ mdbx_assert_fail(env, msg, __func__, __LINE__); \
+ } while (0)
+
+#define mdbx_ensure(env, expr) mdbx_ensure_msg(env, expr, #expr)
+
+/* assert(3) variant in environment context */
+#define mdbx_assert(env, expr) \
+ do { \
+ if (mdbx_assert_enabled()) \
+ mdbx_ensure(env, expr); \
+ } while (0)
+
+/* assert(3) variant in cursor context */
+#define mdbx_cassert(mc, expr) mdbx_assert((mc)->mc_txn->mt_env, expr)
+
+/* assert(3) variant in transaction context */
+#define mdbx_tassert(txn, expr) mdbx_assert((txn)->mt_env, expr)
+
+#ifndef MDBX_TOOLS /* Avoid using internal mdbx_assert() */
+#undef assert
+#define assert(expr) mdbx_assert(NULL, expr)
+#endif
+
+/*----------------------------------------------------------------------------*/
+/* Internal prototypes */
+
+MDBX_INTERNAL_FUNC int mdbx_reader_check0(MDBX_env *env, int rlocked,
+ int *dead);
+MDBX_INTERNAL_FUNC int mdbx_rthc_alloc(mdbx_thread_key_t *key,
+ MDBX_reader *begin, MDBX_reader *end);
+MDBX_INTERNAL_FUNC void mdbx_rthc_remove(const mdbx_thread_key_t key);
+
+MDBX_INTERNAL_FUNC void mdbx_rthc_global_init(void);
+MDBX_INTERNAL_FUNC void mdbx_rthc_global_dtor(void);
+MDBX_INTERNAL_FUNC void mdbx_rthc_thread_dtor(void *ptr);
+
+#define MDBX_IS_ERROR(rc) \
+ ((rc) != MDBX_RESULT_TRUE && (rc) != MDBX_RESULT_FALSE)
+
+/* Internal error codes, not exposed outside libmdbx */
+#define MDBX_NO_ROOT (MDBX_LAST_ERRCODE + 10)
+
+/* Debuging output value of a cursor DBI: Negative in a sub-cursor. */
+#define DDBI(mc) \
+ (((mc)->mc_flags & C_SUB) ? -(int)(mc)->mc_dbi : (int)(mc)->mc_dbi)
+
+/* Key size which fits in a DKBUF. */
+#define DKBUF_MAXKEYSIZE 511 /* FIXME */
+
+#if MDBX_DEBUG
+#define DKBUF char _kbuf[DKBUF_MAXKEYSIZE * 4 + 2]
+#define DKEY(x) mdbx_dump_val(x, _kbuf, DKBUF_MAXKEYSIZE * 2 + 1)
+#define DVAL(x) \
+ mdbx_dump_val(x, _kbuf + DKBUF_MAXKEYSIZE * 2 + 1, DKBUF_MAXKEYSIZE * 2 + 1)
+#else
+#define DKBUF ((void)(0))
+#define DKEY(x) ("-")
+#define DVAL(x) ("-")
+#endif
+
+/* An invalid page number.
+ * Mainly used to denote an empty tree. */
+#define P_INVALID (~(pgno_t)0)
+
+/* Test if the flags f are set in a flag word w. */
+#define F_ISSET(w, f) (((w) & (f)) == (f))
+
+/* Round n up to an even number. */
+#define EVEN(n) (((n) + 1U) & -2) /* sign-extending -2 to match n+1U */
+
+/* Default size of memory map.
+ * This is certainly too small for any actual applications. Apps should
+ * always set the size explicitly using mdbx_env_set_mapsize(). */
+#define DEFAULT_MAPSIZE MEGABYTE
+
+/* Number of slots in the reader table.
+ * This value was chosen somewhat arbitrarily. The 61 is a prime number,
+ * and such readers plus a couple mutexes fit into single 4KB page.
+ * Applications should set the table size using mdbx_env_set_maxreaders(). */
+#define DEFAULT_READERS 61
+
+/* Test if a page is a leaf page */
+#define IS_LEAF(p) (((p)->mp_flags & P_LEAF) != 0)
+/* Test if a page is a LEAF2 page */
+#define IS_LEAF2(p) unlikely(((p)->mp_flags & P_LEAF2) != 0)
+/* Test if a page is a branch page */
+#define IS_BRANCH(p) (((p)->mp_flags & P_BRANCH) != 0)
+/* Test if a page is an overflow page */
+#define IS_OVERFLOW(p) unlikely(((p)->mp_flags & P_OVERFLOW) != 0)
+/* Test if a page is a sub page */
+#define IS_SUBP(p) (((p)->mp_flags & P_SUBP) != 0)
+/* Test if a page is dirty */
+#define IS_DIRTY(p) (((p)->mp_flags & P_DIRTY) != 0)
+
+#define PAGETYPE(p) ((p)->mp_flags & (P_BRANCH | P_LEAF | P_LEAF2 | P_OVERFLOW))
+
+/* Header for a single key/data pair within a page.
+ * Used in pages of type P_BRANCH and P_LEAF without P_LEAF2.
+ * We guarantee 2-byte alignment for 'MDBX_node's.
+ *
+ * mn_lo and mn_hi are used for data size on leaf nodes, and for child
+ * pgno on branch nodes. On 64 bit platforms, mn_flags is also used
+ * for pgno. (Branch nodes have no flags). Lo and hi are in host byte
+ * order in case some accesses can be optimized to 32-bit word access.
+ *
+ * Leaf node flags describe node contents. F_BIGDATA says the node's
+ * data part is the page number of an overflow page with actual data.
+ * F_DUPDATA and F_SUBDATA can be combined giving duplicate data in
+ * a sub-page/sub-database, and named databases (just F_SUBDATA). */
+typedef struct MDBX_node {
+#if __BYTE_ORDER__ == __ORDER_LITTLE_ENDIAN__
+ union {
+ struct {
+ uint16_t mn_lo, mn_hi; /* part of data size or pgno */
+ };
+ uint32_t mn_dsize;
+ uint32_t mn_pgno32;
+ };
+ uint8_t mn_flags; /* see mdbx_node flags */
+ uint8_t mn_extra;
+ uint16_t mn_ksize; /* key size */
+#else
+ uint16_t mn_ksize; /* key size */
+ uint8_t mn_extra;
+ uint8_t mn_flags; /* see mdbx_node flags */
+ union {
+ uint32_t mn_pgno32;
+ uint32_t mn_dsize;
+ struct {
+ uint16_t mn_hi, mn_lo; /* part of data size or pgno */
+ };
+ };
+#endif
+
+ /* mdbx_node Flags */
+#define F_BIGDATA 0x01 /* data put on overflow page */
+#define F_SUBDATA 0x02 /* data is a sub-database */
+#define F_DUPDATA 0x04 /* data has duplicates */
+
+ /* valid flags for mdbx_node_add() */
+#define NODE_ADD_FLAGS (F_DUPDATA | F_SUBDATA | MDBX_RESERVE | MDBX_APPEND)
+ uint8_t mn_data[/* C99 */]; /* key and data are appended here */
+} MDBX_node;
+
+#define MDBX_VALID 0x8000 /* DB handle is valid, for me_dbflags */
+#define PERSISTENT_FLAGS (0xffff & ~(MDBX_VALID))
+/* mdbx_dbi_open() flags */
+#define VALID_FLAGS \
+ (MDBX_REVERSEKEY | MDBX_DUPSORT | MDBX_INTEGERKEY | MDBX_DUPFIXED | \
+ MDBX_INTEGERDUP | MDBX_REVERSEDUP | MDBX_CREATE)
+
+/* max number of pages to commit in one writev() call */
+#define MDBX_COMMIT_PAGES 64
+#if defined(IOV_MAX) && IOV_MAX < MDBX_COMMIT_PAGES /* sysconf(_SC_IOV_MAX) */
+#undef MDBX_COMMIT_PAGES
+#define MDBX_COMMIT_PAGES IOV_MAX
+#endif
+
+/*
+ * /
+ * | -1, a < b
+ * CMP2INT(a,b) = < 0, a == b
+ * | 1, a > b
+ * \
+ */
+#if 1
+/* LY: fast enough on most systems */
+#define CMP2INT(a, b) (((b) > (a)) ? -1 : (a) > (b))
+#else
+#define CMP2INT(a, b) (((a) > (b)) - ((b) > (a)))
+#endif
+
+/* Do not spill pages to disk if txn is getting full, may fail instead */
+#define MDBX_NOSPILL 0x8000
+
+static __maybe_unused __inline pgno_t pgno_add(pgno_t base, pgno_t augend) {
+ assert(base <= MAX_PAGENO);
+ return (augend < MAX_PAGENO - base) ? base + augend : MAX_PAGENO;
+}
+
+static __maybe_unused __inline pgno_t pgno_sub(pgno_t base, pgno_t subtrahend) {
+ assert(base >= MIN_PAGENO);
+ return (subtrahend < base - MIN_PAGENO) ? base - subtrahend : MIN_PAGENO;
+}
+
+static __maybe_unused __inline void mdbx_jitter4testing(bool tiny) {
+#if MDBX_DEBUG
+ if (MDBX_DBG_JITTER & mdbx_runtime_flags)
+ mdbx_osal_jitter(tiny);
+#else
+ (void)tiny;
+#endif
+}
diff --git a/contrib/db/libmdbx/src/elements/lck-posix.c b/contrib/db/libmdbx/src/elements/lck-posix.c
new file mode 100644
index 00000000..147778da
--- /dev/null
+++ b/contrib/db/libmdbx/src/elements/lck-posix.c
@@ -0,0 +1,551 @@
+/*
+ * Copyright 2015-2019 Leonid Yuriev
+ * and other libmdbx authors: please see AUTHORS file.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted only as authorized by the OpenLDAP
+ * Public License.
+ *
+ * A copy of this license is available in the file LICENSE in the
+ * top-level directory of the distribution or, alternatively, at
+ * .
+ */
+
+#include "internals.h"
+
+/*----------------------------------------------------------------------------*/
+/* global constructor/destructor */
+
+#if defined(__linux__) || defined(__gnu_linux__)
+#include
+#ifndef MDBX_ALLOY
+uint32_t mdbx_linux_kernel_version;
+#endif /* MDBX_ALLOY */
+#endif /* Linux */
+
+static __cold __attribute__((__constructor__)) void
+mdbx_global_constructor(void) {
+#if defined(__linux__) || defined(__gnu_linux__)
+ struct utsname buffer;
+ if (uname(&buffer) == 0) {
+ int i = 0;
+ char *p = buffer.release;
+ while (*p && i < 4) {
+ if (*p >= '0' && *p <= '9') {
+ long number = strtol(p, &p, 10);
+ if (number > 0) {
+ if (number > 255)
+ number = 255;
+ mdbx_linux_kernel_version += number << (24 - i * 8);
+ }
+ ++i;
+ } else {
+ ++p;
+ }
+ }
+ }
+#endif /* Linux */
+
+ mdbx_rthc_global_init();
+}
+
+static __cold __attribute__((__destructor__)) void
+mdbx_global_destructor(void) {
+ mdbx_rthc_global_dtor();
+}
+
+/*----------------------------------------------------------------------------*/
+/* lck */
+
+/* Описание реализации блокировок для POSIX & Linux:
+ *
+ * lck-файл отображается в память, в нём организуется таблица читателей и
+ * размещаются совместно используемые posix-мьютексы (futex). Посредством
+ * этих мьютексов (см struct MDBX_lockinfo) реализуются:
+ * - Блокировка таблицы читателей для регистрации,
+ * т.е. функции mdbx_rdt_lock() и mdbx_rdt_unlock().
+ * - Блокировка БД для пишущих транзакций,
+ * т.е. функции mdbx_txn_lock() и mdbx_txn_unlock().
+ *
+ * Остальной функционал реализуется отдельно посредством файловых блокировок:
+ * - Первоначальный захват БД в режиме exclusive/shared и последующий перевод
+ * в операционный режим, функции mdbx_lck_seize() и mdbx_lck_downgrade().
+ * - Проверка присутствие процессов-читателей,
+ * т.е. функции mdbx_rpid_set(), mdbx_rpid_clear() и mdbx_rpid_check().
+ *
+ * Для блокировки файлов используется fcntl(F_SETLK), так как:
+ * - lockf() оперирует только эксклюзивной блокировкой и требует
+ * открытия файла в RW-режиме.
+ * - flock() не гарантирует атомарности при смене блокировок
+ * и оперирует только всем файлом целиком.
+ * - Для контроля процессов-читателей используются однобайтовые
+ * range-блокировки lck-файла посредством fcntl(F_SETLK). При этом
+ * в качестве позиции используется pid процесса-читателя.
+ * - Для первоначального захвата и shared/exclusive выполняется блокировка
+ * основного файла БД и при успехе lck-файла.
+ *
+ * ----------------------------------------------------------------------------
+ * УДЕРЖИВАЕМЫЕ БЛОКИРОВКИ В ЗАВИСИМОСТИ ОТ РЕЖИМА И СОСТОЯНИЯ
+ *
+ * Эксклюзивный режим без lck-файла:
+ * = заблокирован весь dxb-файл посредством F_RDLCK или F_WRLCK,
+ * в зависимости от MDBX_RDONLY.
+ *
+ * Не-операционный режим на время пере-инициализации и разрушении lck-файла:
+ * = F_WRLCK блокировка первого байта lck-файла, другие процессы ждут её
+ * снятия при получении F_RDLCK через F_SETLKW.
+ * - блокировки dxb-файла могут меняться до снятие эксклюзивной блокировки
+ * lck-файла:
+ * + для НЕ-эксклюзивного режима блокировка pid-байта в dxb-файле
+ * посредством F_RDLCK или F_WRLCK, в зависимости от MDBX_RDONLY.
+ * + для ЭКСКЛЮЗИВНОГО режима блокировка pid-байта всего dxb-файла
+ * посредством F_RDLCK или F_WRLCK, в зависимости от MDBX_RDONLY.
+ *
+ * ОПЕРАЦИОННЫЙ режим с lck-файлом:
+ * = F_RDLCK блокировка первого байта lck-файла, другие процессы не могут
+ * получить F_WRLCK и таким образом видят что БД используется.
+ * + F_WRLCK блокировка pid-байта в clk-файле после первой транзакции чтения.
+ * + для НЕ-эксклюзивного режима блокировка pid-байта в dxb-файле
+ * посредством F_RDLCK или F_WRLCK, в зависимости от MDBX_RDONLY.
+ * + для ЭКСКЛЮЗИВНОГО режима блокировка pid-байта всего dxb-файла
+ * посредством F_RDLCK или F_WRLCK, в зависимости от MDBX_RDONLY.
+ */
+
+#if MDBX_USE_OFDLOCKS
+static int op_setlk, op_setlkw, op_getlk;
+static void __cold choice_fcntl() {
+ assert(!op_setlk && !op_setlkw && !op_getlk);
+ if ((mdbx_runtime_flags & MDBX_DBG_LEGACY_MULTIOPEN) == 0
+#if defined(__linux__) || defined(__gnu_linux__)
+ && mdbx_linux_kernel_version >
+ 0x030f0000 /* OFD locks are available since 3.15, but engages here
+ only for 3.16 and larer kernels (LTS) for reliability reasons */
+#endif /* linux */
+ ) {
+ op_setlk = F_OFD_SETLK;
+ op_setlkw = F_OFD_SETLKW;
+ op_getlk = F_OFD_GETLK;
+ return;
+ }
+ op_setlk = F_SETLK;
+ op_setlkw = F_SETLKW;
+ op_getlk = F_GETLK;
+}
+#else
+#define op_setlk F_SETLK
+#define op_setlkw F_SETLKW
+#define op_getlk F_GETLK
+#endif /* MDBX_USE_OFDLOCKS */
+
+#ifndef OFF_T_MAX
+#define OFF_T_MAX \
+ ((sizeof(off_t) > 4 ? INT64_MAX : INT32_MAX) & ~(size_t)0xffff)
+#endif
+
+static int lck_op(mdbx_filehandle_t fd, int cmd, int lck, off_t offset,
+ off_t len) {
+ mdbx_jitter4testing(true);
+ for (;;) {
+ struct flock lock_op;
+ memset(&lock_op, 0, sizeof(lock_op));
+ lock_op.l_type = lck;
+ lock_op.l_whence = SEEK_SET;
+ lock_op.l_start = offset;
+ lock_op.l_len = len;
+ int rc = fcntl(fd, cmd, &lock_op);
+ mdbx_jitter4testing(true);
+ if (rc != -1) {
+ if (cmd == op_getlk) {
+ /* Checks reader by pid. Returns:
+ * MDBX_RESULT_TRUE - if pid is live (unable to acquire lock)
+ * MDBX_RESULT_FALSE - if pid is dead (lock acquired). */
+ return (lock_op.l_type == F_UNLCK) ? MDBX_RESULT_FALSE
+ : MDBX_RESULT_TRUE;
+ }
+ return MDBX_SUCCESS;
+ }
+ rc = errno;
+ if (rc != EINTR || cmd == op_setlkw) {
+ mdbx_assert(nullptr, MDBX_IS_ERROR(rc));
+ return rc;
+ }
+ }
+}
+
+MDBX_INTERNAL_FUNC int mdbx_rpid_set(MDBX_env *env) {
+ assert(env->me_lfd != INVALID_HANDLE_VALUE);
+ assert(env->me_pid > 0);
+ if (unlikely(mdbx_getpid() != env->me_pid))
+ return MDBX_PANIC;
+ return lck_op(env->me_lfd, op_setlk, F_WRLCK, env->me_pid, 1);
+}
+
+MDBX_INTERNAL_FUNC int mdbx_rpid_clear(MDBX_env *env) {
+ assert(env->me_lfd != INVALID_HANDLE_VALUE);
+ assert(env->me_pid > 0);
+ return lck_op(env->me_lfd, op_setlk, F_UNLCK, env->me_pid, 1);
+}
+
+MDBX_INTERNAL_FUNC int mdbx_rpid_check(MDBX_env *env, uint32_t pid) {
+ assert(env->me_lfd != INVALID_HANDLE_VALUE);
+ assert(pid > 0);
+ return lck_op(env->me_lfd, op_getlk, F_WRLCK, pid, 1);
+}
+
+/*---------------------------------------------------------------------------*/
+
+MDBX_INTERNAL_FUNC int __cold mdbx_lck_seize(MDBX_env *env) {
+ assert(env->me_fd != INVALID_HANDLE_VALUE);
+ if (unlikely(mdbx_getpid() != env->me_pid))
+ return MDBX_PANIC;
+#if MDBX_USE_OFDLOCKS
+ if (unlikely(op_setlk == 0))
+ choice_fcntl();
+#endif /* MDBX_USE_OFDLOCKS */
+
+ int rc;
+ if (env->me_lfd == INVALID_HANDLE_VALUE) {
+ /* LY: without-lck mode (e.g. exclusive or on read-only filesystem) */
+ rc =
+ lck_op(env->me_fd, op_setlk,
+ (env->me_flags & MDBX_RDONLY) ? F_RDLCK : F_WRLCK, 0, OFF_T_MAX);
+ if (rc != MDBX_SUCCESS) {
+ mdbx_error("%s(%s) failed: errcode %u", __func__, "without-lck", rc);
+ mdbx_assert(env, MDBX_IS_ERROR(rc));
+ return rc;
+ }
+ return MDBX_RESULT_TRUE /* Done: return with exclusive locking. */;
+ }
+
+ /* Firstly try to get exclusive locking. */
+ rc = lck_op(env->me_lfd, op_setlk, F_WRLCK, 0, 1);
+ if (rc == MDBX_SUCCESS) {
+ continue_dxb_exclusive:
+ rc =
+ lck_op(env->me_fd, op_setlk,
+ (env->me_flags & MDBX_RDONLY) ? F_RDLCK : F_WRLCK, 0, OFF_T_MAX);
+ if (rc == MDBX_SUCCESS)
+ return MDBX_RESULT_TRUE /* Done: return with exclusive locking. */;
+
+ /* the cause may be a collision with POSIX's file-lock recovery. */
+ if (!(rc == EAGAIN || rc == EACCES || rc == EBUSY || rc == EWOULDBLOCK ||
+ rc == EDEADLK)) {
+ mdbx_error("%s(%s) failed: errcode %u", __func__, "dxb-exclusive", rc);
+ mdbx_assert(env, MDBX_IS_ERROR(rc));
+ return rc;
+ }
+
+ /* Fallback to lck-shared */
+ rc = lck_op(env->me_lfd, op_setlk, F_RDLCK, 0, 1);
+ if (rc != MDBX_SUCCESS) {
+ mdbx_error("%s(%s) failed: errcode %u", __func__, "fallback-shared", rc);
+ mdbx_assert(env, MDBX_IS_ERROR(rc));
+ return rc;
+ }
+ /* Done: return with shared locking. */
+ return MDBX_RESULT_FALSE;
+ }
+
+ /* Wait for lck-shared now. */
+ /* Here may be await during transient processes, for instance until another
+ * competing process doesn't call lck_downgrade(). */
+ rc = lck_op(env->me_lfd, op_setlkw, F_RDLCK, 0, 1);
+ if (rc != MDBX_SUCCESS) {
+ mdbx_error("%s(%s) failed: errcode %u", __func__, "try-shared", rc);
+ mdbx_assert(env, MDBX_IS_ERROR(rc));
+ return rc;
+ }
+
+ /* Lock against another process operating in without-lck or exclusive mode. */
+ rc =
+ lck_op(env->me_fd, op_setlk,
+ (env->me_flags & MDBX_RDONLY) ? F_RDLCK : F_WRLCK, env->me_pid, 1);
+ if (rc != MDBX_SUCCESS) {
+ mdbx_error("%s(%s) failed: errcode %u", __func__,
+ "lock-against-without-lck", rc);
+ mdbx_assert(env, MDBX_IS_ERROR(rc));
+ return rc;
+ }
+
+ /* got shared, retry exclusive */
+ rc = lck_op(env->me_lfd, op_setlk, F_WRLCK, 0, 1);
+ if (rc == MDBX_SUCCESS)
+ goto continue_dxb_exclusive;
+
+ if (rc == EAGAIN || rc == EACCES || rc == EBUSY || rc == EWOULDBLOCK ||
+ rc == EDEADLK)
+ return MDBX_RESULT_FALSE /* Done: exclusive is unavailable,
+ but shared locks are alive. */
+ ;
+
+ mdbx_error("%s(%s) failed: errcode %u", __func__, "try-exclusive", rc);
+ mdbx_assert(env, MDBX_IS_ERROR(rc));
+ return rc;
+}
+
+MDBX_INTERNAL_FUNC int mdbx_lck_downgrade(MDBX_env *env) {
+ assert(env->me_lfd != INVALID_HANDLE_VALUE);
+ if (unlikely(mdbx_getpid() != env->me_pid))
+ return MDBX_PANIC;
+
+ int rc = MDBX_SUCCESS;
+ if ((env->me_flags & MDBX_EXCLUSIVE) == 0) {
+ rc = lck_op(env->me_fd, op_setlk, F_UNLCK, 0, env->me_pid);
+ if (rc == MDBX_SUCCESS)
+ rc = lck_op(env->me_fd, op_setlk, F_UNLCK, env->me_pid + 1,
+ OFF_T_MAX - env->me_pid - 1);
+ }
+ if (rc == MDBX_SUCCESS)
+ rc = lck_op(env->me_lfd, op_setlk, F_RDLCK, 0, 1);
+ if (unlikely(rc != 0)) {
+ mdbx_error("%s(%s) failed: errcode %u", __func__, "lck", rc);
+ assert(MDBX_IS_ERROR(rc));
+ }
+ return rc;
+}
+
+MDBX_INTERNAL_FUNC int __cold mdbx_lck_destroy(MDBX_env *env,
+ MDBX_env *inprocess_neighbor) {
+ if (unlikely(mdbx_getpid() != env->me_pid))
+ return MDBX_PANIC;
+
+ int rc = MDBX_SUCCESS;
+ if (env->me_lfd != INVALID_HANDLE_VALUE && !inprocess_neighbor &&
+ env->me_lck &&
+ /* try get exclusive access */
+ lck_op(env->me_lfd, op_setlk, F_WRLCK, 0, OFF_T_MAX) == 0 &&
+ lck_op(env->me_fd, op_setlk,
+ (env->me_flags & MDBX_RDONLY) ? F_RDLCK : F_WRLCK, 0, OFF_T_MAX)) {
+ mdbx_verbose("%s: got exclusive, drown mutexes", __func__);
+ rc = pthread_mutex_destroy(&env->me_lck->mti_rmutex);
+ if (rc == 0)
+ rc = pthread_mutex_destroy(&env->me_lck->mti_wmutex);
+ mdbx_assert(env, rc == 0);
+ if (rc == 0) {
+ memset(env->me_lck, 0x81, sizeof(MDBX_lockinfo));
+ msync(env->me_lck, env->me_os_psize, MS_ASYNC);
+ }
+ mdbx_jitter4testing(false);
+ }
+
+ /* 1) POSIX's fcntl() locks (i.e. when op_setlk == F_SETLK) should be restored
+ * after file was closed.
+ *
+ * 2) File locks would be released (by kernel) while the file-descriptors will
+ * be closed. But to avoid false-positive EACCESS and EDEADLK from the kernel,
+ * locks should be released here explicitly with properly order. */
+
+ /* close dxb and restore lock */
+ if (env->me_fd != INVALID_HANDLE_VALUE) {
+ if (unlikely(close(env->me_fd) != 0) && rc == MDBX_SUCCESS)
+ rc = errno;
+ env->me_fd = INVALID_HANDLE_VALUE;
+ if (op_setlk == F_SETLK && inprocess_neighbor && rc == MDBX_SUCCESS) {
+ /* restore file-lock */
+ rc = lck_op(
+ inprocess_neighbor->me_fd, F_SETLKW,
+ (inprocess_neighbor->me_flags & MDBX_RDONLY) ? F_RDLCK : F_WRLCK,
+ (inprocess_neighbor->me_flags & MDBX_EXCLUSIVE)
+ ? 0
+ : inprocess_neighbor->me_pid,
+ (inprocess_neighbor->me_flags & MDBX_EXCLUSIVE) ? OFF_T_MAX : 1);
+ }
+ }
+
+ /* close clk and restore locks */
+ if (env->me_lfd != INVALID_HANDLE_VALUE) {
+ if (unlikely(close(env->me_lfd) != 0) && rc == MDBX_SUCCESS)
+ rc = errno;
+ env->me_lfd = INVALID_HANDLE_VALUE;
+ if (op_setlk == F_SETLK && inprocess_neighbor && rc == MDBX_SUCCESS) {
+ /* restore file-locks */
+ rc = lck_op(inprocess_neighbor->me_lfd, F_SETLKW, F_RDLCK, 0, 1);
+ if (rc == MDBX_SUCCESS && inprocess_neighbor->me_live_reader)
+ rc = mdbx_rpid_set(inprocess_neighbor);
+ }
+ }
+
+ if (inprocess_neighbor && rc != MDBX_SUCCESS)
+ inprocess_neighbor->me_flags |= MDBX_FATAL_ERROR;
+ return rc;
+}
+
+/*---------------------------------------------------------------------------*/
+
+static int mdbx_mutex_failed(MDBX_env *env, pthread_mutex_t *mutex,
+ const int rc);
+
+MDBX_INTERNAL_FUNC int __cold mdbx_lck_init(MDBX_env *env,
+ MDBX_env *inprocess_neighbor,
+ int global_uniqueness_flag) {
+ if (inprocess_neighbor)
+ return MDBX_SUCCESS /* currently don't need any initialization
+ if LCK already opened/used inside current process */
+ ;
+
+ /* FIXME: Unfortunately, there is no other reliable way but to long testing
+ * on each platform. On the other hand, behavior like FreeBSD is incorrect
+ * and we can expect it to be rare. Moreover, even on FreeBSD without
+ * additional in-process initialization, the probability of an problem
+ * occurring is vanishingly small, and the symptom is a return of EINVAL
+ * while locking a mutex. In other words, in the worst case, the problem
+ * results in an EINVAL error at the start of the transaction, but NOT data
+ * loss, nor database corruption, nor other fatal troubles. Thus, the code
+ * below I am inclined to think the workaround for erroneous platforms (like
+ * FreeBSD), rather than a defect of libmdbx. */
+#if defined(__FreeBSD__)
+ /* seems that shared mutexes on FreeBSD required in-process initialization */
+ (void)global_uniqueness_flag;
+#else
+ /* shared mutexes on many other platforms (including Darwin and Linux's
+ * futexes) doesn't need any addition in-process initialization */
+ if (global_uniqueness_flag != MDBX_RESULT_TRUE)
+ return MDBX_SUCCESS;
+#endif
+
+ pthread_mutexattr_t ma;
+ int rc = pthread_mutexattr_init(&ma);
+ if (rc)
+ return rc;
+
+ rc = pthread_mutexattr_setpshared(&ma, PTHREAD_PROCESS_SHARED);
+ if (rc)
+ goto bailout;
+
+#if MDBX_USE_ROBUST
+#if defined(__GLIBC__) && !__GLIBC_PREREQ(2, 12) && \
+ !defined(pthread_mutex_consistent) && _POSIX_C_SOURCE < 200809L
+ rc = pthread_mutexattr_setrobust_np(&ma, PTHREAD_MUTEX_ROBUST_NP);
+#else
+ rc = pthread_mutexattr_setrobust(&ma, PTHREAD_MUTEX_ROBUST);
+#endif
+ if (rc)
+ goto bailout;
+#endif /* MDBX_USE_ROBUST */
+
+#if _POSIX_C_SOURCE >= 199506L && !defined(MDBX_SAFE4QEMU)
+ rc = pthread_mutexattr_setprotocol(&ma, PTHREAD_PRIO_INHERIT);
+ if (rc == ENOTSUP)
+ rc = pthread_mutexattr_setprotocol(&ma, PTHREAD_PRIO_NONE);
+ if (rc)
+ goto bailout;
+#endif /* PTHREAD_PRIO_INHERIT */
+
+ rc = pthread_mutexattr_settype(&ma, PTHREAD_MUTEX_ERRORCHECK);
+ if (rc)
+ goto bailout;
+
+ rc = pthread_mutex_init(&env->me_lck->mti_rmutex, &ma);
+ if (rc)
+ goto bailout;
+ rc = pthread_mutex_init(&env->me_lck->mti_wmutex, &ma);
+
+bailout:
+ pthread_mutexattr_destroy(&ma);
+ return rc;
+}
+
+static int mdbx_robust_lock(MDBX_env *env, pthread_mutex_t *mutex) {
+ mdbx_jitter4testing(true);
+ int rc = pthread_mutex_lock(mutex);
+ if (unlikely(rc != 0))
+ rc = mdbx_mutex_failed(env, mutex, rc);
+ return rc;
+}
+
+static int mdbx_robust_trylock(MDBX_env *env, pthread_mutex_t *mutex) {
+ mdbx_jitter4testing(true);
+ int rc = pthread_mutex_trylock(mutex);
+ if (unlikely(rc != 0 && rc != EBUSY))
+ rc = mdbx_mutex_failed(env, mutex, rc);
+ return (rc != EBUSY) ? rc : MDBX_BUSY;
+}
+
+static int mdbx_robust_unlock(MDBX_env *env, pthread_mutex_t *mutex) {
+ int rc = pthread_mutex_unlock(mutex);
+ mdbx_jitter4testing(true);
+ if (unlikely(rc != 0))
+ env->me_flags |= MDBX_FATAL_ERROR;
+ return rc;
+}
+
+MDBX_INTERNAL_FUNC int mdbx_rdt_lock(MDBX_env *env) {
+ mdbx_trace("%s", ">>");
+ int rc = mdbx_robust_lock(env, &env->me_lck->mti_rmutex);
+ mdbx_trace("<< rc %d", rc);
+ return rc;
+}
+
+MDBX_INTERNAL_FUNC void mdbx_rdt_unlock(MDBX_env *env) {
+ mdbx_trace("%s", ">>");
+ int rc = mdbx_robust_unlock(env, &env->me_lck->mti_rmutex);
+ mdbx_trace("<< rc %d", rc);
+ if (unlikely(MDBX_IS_ERROR(rc)))
+ mdbx_panic("%s() failed: errcode %d\n", __func__, rc);
+}
+
+int mdbx_txn_lock(MDBX_env *env, bool dontwait) {
+ mdbx_trace("%s", ">>");
+ int rc = dontwait ? mdbx_robust_trylock(env, env->me_wmutex)
+ : mdbx_robust_lock(env, env->me_wmutex);
+ mdbx_trace("<< rc %d", rc);
+ return MDBX_IS_ERROR(rc) ? rc : MDBX_SUCCESS;
+}
+
+void mdbx_txn_unlock(MDBX_env *env) {
+ mdbx_trace("%s", ">>");
+ int rc = mdbx_robust_unlock(env, env->me_wmutex);
+ mdbx_trace("<< rc %d", rc);
+ if (unlikely(MDBX_IS_ERROR(rc)))
+ mdbx_panic("%s() failed: errcode %d\n", __func__, rc);
+}
+
+static int __cold mdbx_mutex_failed(MDBX_env *env, pthread_mutex_t *mutex,
+ const int err) {
+ int rc = err;
+#if MDBX_USE_ROBUST
+ if (err == EOWNERDEAD) {
+ /* We own the mutex. Clean up after dead previous owner. */
+
+ int rlocked = (env->me_lck && mutex == &env->me_lck->mti_rmutex);
+ rc = MDBX_SUCCESS;
+ if (!rlocked) {
+ if (unlikely(env->me_txn)) {
+ /* env is hosed if the dead thread was ours */
+ env->me_flags |= MDBX_FATAL_ERROR;
+ env->me_txn = NULL;
+ rc = MDBX_PANIC;
+ }
+ }
+ mdbx_notice("%cmutex owner died, %s", (rlocked ? 'r' : 'w'),
+ (rc ? "this process' env is hosed" : "recovering"));
+
+ int check_rc = mdbx_reader_check0(env, rlocked, NULL);
+ check_rc = (check_rc == MDBX_SUCCESS) ? MDBX_RESULT_TRUE : check_rc;
+
+#if defined(__GLIBC__) && !__GLIBC_PREREQ(2, 12) && \
+ !defined(pthread_mutex_consistent) && _POSIX_C_SOURCE < 200809L
+ int mreco_rc = pthread_mutex_consistent_np(mutex);
+#else
+ int mreco_rc = pthread_mutex_consistent(mutex);
+#endif
+ check_rc = (mreco_rc == 0) ? check_rc : mreco_rc;
+
+ if (unlikely(mreco_rc))
+ mdbx_error("mutex recovery failed, %s", mdbx_strerror(mreco_rc));
+
+ rc = (rc == MDBX_SUCCESS) ? check_rc : rc;
+ if (MDBX_IS_ERROR(rc))
+ pthread_mutex_unlock(mutex);
+ return rc;
+ }
+#else
+ (void)mutex;
+#endif /* MDBX_USE_ROBUST */
+
+ mdbx_error("mutex (un)lock failed, %s", mdbx_strerror(err));
+ if (rc != EDEADLK)
+ env->me_flags |= MDBX_FATAL_ERROR;
+ return rc;
+}
diff --git a/contrib/db/libmdbx/src/elements/lck-windows.c b/contrib/db/libmdbx/src/elements/lck-windows.c
new file mode 100644
index 00000000..5d74bb8c
--- /dev/null
+++ b/contrib/db/libmdbx/src/elements/lck-windows.c
@@ -0,0 +1,777 @@
+/*
+ * Copyright 2015-2019 Leonid Yuriev
+ * and other libmdbx authors: please see AUTHORS file.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted only as authorized by the OpenLDAP
+ * Public License.
+ *
+ * A copy of this license is available in the file LICENSE in the
+ * top-level directory of the distribution or, alternatively, at
+ * .
+ */
+
+#include "internals.h"
+
+/* PREAMBLE FOR WINDOWS:
+ *
+ * We are not concerned for performance here.
+ * If you are running Windows a performance could NOT be the goal.
+ * Otherwise please use Linux.
+ *
+ * Regards,
+ * LY
+ */
+
+static void mdbx_winnt_import(void);
+
+#if MDBX_BUILD_SHARED_LIBRARY
+#if MDBX_AVOID_CRT && defined(NDEBUG)
+/* DEBUG/CHECKED builds still require MSVC's CRT for runtime checks.
+ *
+ * Define dll's entry point only for Release build when NDEBUG is defined and
+ * MDBX_AVOID_CRT=ON. if the entry point isn't defined then MSVC's will
+ * automatically use DllMainCRTStartup() from CRT library, which also
+ * automatically call DllMain() from our mdbx.dll */
+#pragma comment(linker, "/ENTRY:DllMain")
+#endif /* MDBX_AVOID_CRT */
+
+BOOL APIENTRY DllMain(HANDLE module, DWORD reason, LPVOID reserved)
+#else
+#if !MDBX_CONFIG_MANUAL_TLS_CALLBACK
+static
+#endif /* !MDBX_CONFIG_MANUAL_TLS_CALLBACK */
+ void NTAPI
+ mdbx_dll_handler(PVOID module, DWORD reason, PVOID reserved)
+#endif /* MDBX_BUILD_SHARED_LIBRARY */
+{
+ (void)reserved;
+ switch (reason) {
+ case DLL_PROCESS_ATTACH:
+ mdbx_winnt_import();
+ mdbx_rthc_global_init();
+ break;
+ case DLL_PROCESS_DETACH:
+ mdbx_rthc_global_dtor();
+ break;
+
+ case DLL_THREAD_ATTACH:
+ break;
+ case DLL_THREAD_DETACH:
+ mdbx_rthc_thread_dtor(module);
+ break;
+ }
+#if MDBX_BUILD_SHARED_LIBRARY
+ return TRUE;
+#endif
+}
+
+#if !MDBX_BUILD_SHARED_LIBRARY && !MDBX_CONFIG_MANUAL_TLS_CALLBACK
+/* *INDENT-OFF* */
+/* clang-format off */
+#if defined(_MSC_VER)
+# pragma const_seg(push)
+# pragma data_seg(push)
+
+# ifdef _WIN64
+ /* kick a linker to create the TLS directory if not already done */
+# pragma comment(linker, "/INCLUDE:_tls_used")
+ /* Force some symbol references. */
+# pragma comment(linker, "/INCLUDE:mdbx_tls_anchor")
+ /* specific const-segment for WIN64 */
+# pragma const_seg(".CRT$XLB")
+ const
+# else
+ /* kick a linker to create the TLS directory if not already done */
+# pragma comment(linker, "/INCLUDE:__tls_used")
+ /* Force some symbol references. */
+# pragma comment(linker, "/INCLUDE:_mdbx_tls_anchor")
+ /* specific data-segment for WIN32 */
+# pragma data_seg(".CRT$XLB")
+# endif
+
+ __declspec(allocate(".CRT$XLB")) PIMAGE_TLS_CALLBACK mdbx_tls_anchor = mdbx_dll_handler;
+# pragma data_seg(pop)
+# pragma const_seg(pop)
+
+#elif defined(__GNUC__)
+# ifdef _WIN64
+ const
+# endif
+ PIMAGE_TLS_CALLBACK mdbx_tls_anchor __attribute__((__section__(".CRT$XLB"), used)) = mdbx_dll_handler;
+#else
+# error FIXME
+#endif
+/* *INDENT-ON* */
+/* clang-format on */
+#endif /* !MDBX_BUILD_SHARED_LIBRARY && !MDBX_CONFIG_MANUAL_TLS_CALLBACK */
+
+/*----------------------------------------------------------------------------*/
+
+#define LCK_SHARED 0
+#define LCK_EXCLUSIVE LOCKFILE_EXCLUSIVE_LOCK
+#define LCK_WAITFOR 0
+#define LCK_DONTWAIT LOCKFILE_FAIL_IMMEDIATELY
+
+static __inline BOOL flock(mdbx_filehandle_t fd, DWORD flags, uint64_t offset,
+ size_t bytes) {
+ OVERLAPPED ov;
+ ov.hEvent = 0;
+ ov.Offset = (DWORD)offset;
+ ov.OffsetHigh = HIGH_DWORD(offset);
+ return LockFileEx(fd, flags, 0, (DWORD)bytes, HIGH_DWORD(bytes), &ov);
+}
+
+static __inline BOOL funlock(mdbx_filehandle_t fd, uint64_t offset,
+ size_t bytes) {
+ return UnlockFile(fd, (DWORD)offset, HIGH_DWORD(offset), (DWORD)bytes,
+ HIGH_DWORD(bytes));
+}
+
+/*----------------------------------------------------------------------------*/
+/* global `write` lock for write-txt processing,
+ * exclusive locking both meta-pages) */
+
+#define LCK_MAXLEN (1u + (size_t)(MAXSSIZE_T))
+#define LCK_META_OFFSET 0
+#define LCK_META_LEN 0x10000u
+#define LCK_BODY_OFFSET LCK_META_LEN
+#define LCK_BODY_LEN (LCK_MAXLEN - LCK_BODY_OFFSET)
+#define LCK_META LCK_META_OFFSET, LCK_META_LEN
+#define LCK_BODY LCK_BODY_OFFSET, LCK_BODY_LEN
+#define LCK_WHOLE 0, LCK_MAXLEN
+
+int mdbx_txn_lock(MDBX_env *env, bool dontwait) {
+ if (dontwait) {
+ if (!TryEnterCriticalSection(&env->me_windowsbug_lock))
+ return MDBX_BUSY;
+ } else {
+ EnterCriticalSection(&env->me_windowsbug_lock);
+ }
+
+ if ((env->me_flags & MDBX_EXCLUSIVE) ||
+ flock(env->me_fd,
+ dontwait ? (LCK_EXCLUSIVE | LCK_DONTWAIT)
+ : (LCK_EXCLUSIVE | LCK_WAITFOR),
+ LCK_BODY))
+ return MDBX_SUCCESS;
+ int rc = GetLastError();
+ LeaveCriticalSection(&env->me_windowsbug_lock);
+ return (!dontwait || rc != ERROR_LOCK_VIOLATION) ? rc : MDBX_BUSY;
+}
+
+void mdbx_txn_unlock(MDBX_env *env) {
+ int rc =
+ (env->me_flags & MDBX_EXCLUSIVE) ? TRUE : funlock(env->me_fd, LCK_BODY);
+ LeaveCriticalSection(&env->me_windowsbug_lock);
+ if (!rc)
+ mdbx_panic("%s failed: errcode %u", __func__, GetLastError());
+}
+
+/*----------------------------------------------------------------------------*/
+/* global `read` lock for readers registration,
+ * exclusive locking `mti_numreaders` (second) cacheline */
+
+#define LCK_LO_OFFSET 0
+#define LCK_LO_LEN offsetof(MDBX_lockinfo, mti_numreaders)
+#define LCK_UP_OFFSET LCK_LO_LEN
+#define LCK_UP_LEN (sizeof(MDBX_lockinfo) - LCK_UP_OFFSET)
+#define LCK_LOWER LCK_LO_OFFSET, LCK_LO_LEN
+#define LCK_UPPER LCK_UP_OFFSET, LCK_UP_LEN
+
+MDBX_INTERNAL_FUNC int mdbx_rdt_lock(MDBX_env *env) {
+ mdbx_srwlock_AcquireShared(&env->me_remap_guard);
+ if (env->me_lfd == INVALID_HANDLE_VALUE)
+ return MDBX_SUCCESS; /* readonly database in readonly filesystem */
+
+ /* transite from S-? (used) to S-E (locked), e.g. exclusive lock upper-part */
+ if ((env->me_flags & MDBX_EXCLUSIVE) ||
+ flock(env->me_lfd, LCK_EXCLUSIVE | LCK_WAITFOR, LCK_UPPER))
+ return MDBX_SUCCESS;
+
+ int rc = GetLastError();
+ mdbx_srwlock_ReleaseShared(&env->me_remap_guard);
+ return rc;
+}
+
+MDBX_INTERNAL_FUNC void mdbx_rdt_unlock(MDBX_env *env) {
+ if (env->me_lfd != INVALID_HANDLE_VALUE) {
+ /* transite from S-E (locked) to S-? (used), e.g. unlock upper-part */
+ if ((env->me_flags & MDBX_EXCLUSIVE) == 0 &&
+ !funlock(env->me_lfd, LCK_UPPER))
+ mdbx_panic("%s failed: errcode %u", __func__, GetLastError());
+ }
+ mdbx_srwlock_ReleaseShared(&env->me_remap_guard);
+}
+
+static int suspend_and_append(mdbx_handle_array_t **array,
+ const DWORD ThreadId) {
+ const unsigned limit = (*array)->limit;
+ if ((*array)->count == limit) {
+ void *ptr = mdbx_realloc(
+ (limit > ARRAY_LENGTH((*array)->handles))
+ ? *array
+ : /* don't free initial array on the stack */ NULL,
+ sizeof(mdbx_handle_array_t) +
+ sizeof(HANDLE) * (limit * 2 - ARRAY_LENGTH((*array)->handles)));
+ if (!ptr)
+ return MDBX_ENOMEM;
+ if (limit == ARRAY_LENGTH((*array)->handles))
+ memcpy(ptr, *array, sizeof(mdbx_handle_array_t));
+ *array = (mdbx_handle_array_t *)ptr;
+ (*array)->limit = limit * 2;
+ }
+
+ HANDLE hThread = OpenThread(THREAD_SUSPEND_RESUME | THREAD_QUERY_INFORMATION,
+ FALSE, ThreadId);
+ if (hThread == NULL)
+ return GetLastError();
+
+ if (SuspendThread(hThread) == -1) {
+ int err = GetLastError();
+ DWORD ExitCode;
+ if (err == /* workaround for Win10 UCRT bug */ ERROR_ACCESS_DENIED ||
+ !GetExitCodeThread(hThread, &ExitCode) || ExitCode != STILL_ACTIVE)
+ err = MDBX_SUCCESS;
+ CloseHandle(hThread);
+ return err;
+ }
+
+ (*array)->handles[(*array)->count++] = hThread;
+ return MDBX_SUCCESS;
+}
+
+MDBX_INTERNAL_FUNC int
+mdbx_suspend_threads_before_remap(MDBX_env *env, mdbx_handle_array_t **array) {
+ const size_t CurrentTid = GetCurrentThreadId();
+ int rc;
+ if (env->me_lck) {
+ /* Scan LCK for threads of the current process */
+ const MDBX_reader *const begin = env->me_lck->mti_readers;
+ const MDBX_reader *const end = begin + env->me_lck->mti_numreaders;
+ const size_t WriteTxnOwner = env->me_txn0 ? env->me_txn0->mt_owner : 0;
+ for (const MDBX_reader *reader = begin; reader < end; ++reader) {
+ if (reader->mr_pid != env->me_pid || !reader->mr_tid) {
+ skip_lck:
+ continue;
+ }
+ if (reader->mr_tid == CurrentTid || reader->mr_tid == WriteTxnOwner)
+ goto skip_lck;
+ if (env->me_flags & MDBX_NOTLS) {
+ /* Skip duplicates in no-tls mode */
+ for (const MDBX_reader *scan = reader; --scan >= begin;)
+ if (scan->mr_tid == reader->mr_tid)
+ goto skip_lck;
+ }
+
+ rc = suspend_and_append(array, (mdbx_tid_t)reader->mr_tid);
+ if (rc != MDBX_SUCCESS) {
+ bailout_lck:
+ (void)mdbx_resume_threads_after_remap(*array);
+ return rc;
+ }
+ }
+ if (WriteTxnOwner && WriteTxnOwner != CurrentTid) {
+ rc = suspend_and_append(array, (mdbx_tid_t)WriteTxnOwner);
+ if (rc != MDBX_SUCCESS)
+ goto bailout_lck;
+ }
+ } else {
+ /* Without LCK (i.e. read-only mode).
+ * Walk thougth a snapshot of all running threads */
+ mdbx_assert(env,
+ env->me_txn0 == NULL || (env->me_flags & MDBX_EXCLUSIVE) != 0);
+ const HANDLE hSnapshot = CreateToolhelp32Snapshot(TH32CS_SNAPTHREAD, 0);
+ if (hSnapshot == INVALID_HANDLE_VALUE)
+ return GetLastError();
+
+ THREADENTRY32 entry;
+ entry.dwSize = sizeof(THREADENTRY32);
+
+ if (!Thread32First(hSnapshot, &entry)) {
+ rc = GetLastError();
+ bailout_toolhelp:
+ CloseHandle(hSnapshot);
+ (void)mdbx_resume_threads_after_remap(*array);
+ return rc;
+ }
+
+ do {
+ if (entry.th32OwnerProcessID != env->me_pid ||
+ entry.th32ThreadID == CurrentTid)
+ continue;
+
+ rc = suspend_and_append(array, entry.th32ThreadID);
+ if (rc != MDBX_SUCCESS)
+ goto bailout_toolhelp;
+
+ } while (Thread32Next(hSnapshot, &entry));
+
+ rc = GetLastError();
+ if (rc != ERROR_NO_MORE_FILES)
+ goto bailout_toolhelp;
+ CloseHandle(hSnapshot);
+ }
+
+ return MDBX_SUCCESS;
+}
+
+MDBX_INTERNAL_FUNC int
+mdbx_resume_threads_after_remap(mdbx_handle_array_t *array) {
+ int rc = MDBX_SUCCESS;
+ for (unsigned i = 0; i < array->count; ++i) {
+ const HANDLE hThread = array->handles[i];
+ if (ResumeThread(hThread) == -1) {
+ const int err = GetLastError();
+ DWORD ExitCode;
+ if (err != /* workaround for Win10 UCRT bug */ ERROR_ACCESS_DENIED &&
+ GetExitCodeThread(hThread, &ExitCode) && ExitCode == STILL_ACTIVE)
+ rc = err;
+ }
+ CloseHandle(hThread);
+ }
+ return rc;
+}
+
+/*----------------------------------------------------------------------------*/
+/* global `initial` lock for lockfile initialization,
+ * exclusive/shared locking first cacheline */
+
+/* Briefly descritpion of locking schema/algorithm:
+ * - Windows does not support upgrading or downgrading for file locking.
+ * - Therefore upgrading/downgrading is emulated by shared and exclusive
+ * locking of upper and lower halves.
+ * - In other words, we have FSM with possible 9 states,
+ * i.e. free/shared/exclusive x free/shared/exclusive == 9.
+ * Only 6 states of FSM are used, which 2 of ones are transitive.
+ *
+ * The mdbx_lck_seize() moves the locking-FSM from the initial free/unlocked
+ * state to the "exclusive write" (and returns MDBX_RESULT_TRUE) if possible,
+ * or to the "used" (and returns MDBX_RESULT_FALSE).
+ *
+ * The mdbx_lck_downgrade() moves the locking-FSM from "exclusive write"
+ * state to the "used" (i.e. shared) state.
+ *
+ * States:
+ * ?-? = free, i.e. unlocked
+ * S-? = used, i.e. shared lock
+ * E-? = exclusive-read, i.e. operational exclusive
+ * ?-S
+ * ?-E = middle (transitive state)
+ * S-S
+ * S-E = locked (transitive state)
+ * E-S
+ * E-E = exclusive-write, i.e. exclusive due (re)initialization
+ */
+
+static void lck_unlock(MDBX_env *env) {
+ int rc;
+
+ if (env->me_lfd != INVALID_HANDLE_VALUE) {
+ /* double `unlock` for robustly remove overlapped shared/exclusive locks */
+ while (funlock(env->me_lfd, LCK_LOWER))
+ ;
+ rc = GetLastError();
+ assert(rc == ERROR_NOT_LOCKED);
+ (void)rc;
+ SetLastError(ERROR_SUCCESS);
+
+ while (funlock(env->me_lfd, LCK_UPPER))
+ ;
+ rc = GetLastError();
+ assert(rc == ERROR_NOT_LOCKED);
+ (void)rc;
+ SetLastError(ERROR_SUCCESS);
+ }
+
+ if (env->me_fd != INVALID_HANDLE_VALUE) {
+ /* explicitly unlock to avoid latency for other processes (windows kernel
+ * releases such locks via deferred queues) */
+ while (funlock(env->me_fd, LCK_BODY))
+ ;
+ rc = GetLastError();
+ assert(rc == ERROR_NOT_LOCKED);
+ (void)rc;
+ SetLastError(ERROR_SUCCESS);
+
+ while (funlock(env->me_fd, LCK_META))
+ ;
+ rc = GetLastError();
+ assert(rc == ERROR_NOT_LOCKED);
+ (void)rc;
+ SetLastError(ERROR_SUCCESS);
+
+ while (funlock(env->me_fd, LCK_WHOLE))
+ ;
+ rc = GetLastError();
+ assert(rc == ERROR_NOT_LOCKED);
+ (void)rc;
+ SetLastError(ERROR_SUCCESS);
+ }
+}
+
+MDBX_INTERNAL_FUNC int mdbx_lck_init(MDBX_env *env,
+ MDBX_env *inprocess_neighbor,
+ int global_uniqueness_flag) {
+ (void)env;
+ (void)inprocess_neighbor;
+ (void)global_uniqueness_flag;
+ return MDBX_SUCCESS;
+}
+
+MDBX_INTERNAL_FUNC int mdbx_lck_destroy(MDBX_env *env,
+ MDBX_env *inprocess_neighbor) {
+ (void)inprocess_neighbor;
+
+ /* LY: should unmap before releasing the locks to avoid race condition and
+ * STATUS_USER_MAPPED_FILE/ERROR_USER_MAPPED_FILE */
+ if (env->me_map)
+ mdbx_munmap(&env->me_dxb_mmap);
+ if (env->me_lck)
+ mdbx_munmap(&env->me_lck_mmap);
+
+ lck_unlock(env);
+ return MDBX_SUCCESS;
+}
+
+/* Seize state as 'exclusive-write' (E-E and returns MDBX_RESULT_TRUE)
+ * or as 'used' (S-? and returns MDBX_RESULT_FALSE).
+ * Oherwise returns an error. */
+static int internal_seize_lck(HANDLE lfd) {
+ int rc;
+ assert(lfd != INVALID_HANDLE_VALUE);
+
+ /* 1) now on ?-? (free), get ?-E (middle) */
+ mdbx_jitter4testing(false);
+ if (!flock(lfd, LCK_EXCLUSIVE | LCK_WAITFOR, LCK_UPPER)) {
+ rc = GetLastError() /* 2) something went wrong, give up */;
+ mdbx_error("%s(%s) failed: errcode %u", __func__,
+ "?-?(free) >> ?-E(middle)", rc);
+ return rc;
+ }
+
+ /* 3) now on ?-E (middle), try E-E (exclusive-write) */
+ mdbx_jitter4testing(false);
+ if (flock(lfd, LCK_EXCLUSIVE | LCK_DONTWAIT, LCK_LOWER))
+ return MDBX_RESULT_TRUE /* 4) got E-E (exclusive-write), done */;
+
+ /* 5) still on ?-E (middle) */
+ rc = GetLastError();
+ mdbx_jitter4testing(false);
+ if (rc != ERROR_SHARING_VIOLATION && rc != ERROR_LOCK_VIOLATION) {
+ /* 6) something went wrong, give up */
+ if (!funlock(lfd, LCK_UPPER))
+ mdbx_panic("%s(%s) failed: errcode %u", __func__,
+ "?-E(middle) >> ?-?(free)", GetLastError());
+ return rc;
+ }
+
+ /* 7) still on ?-E (middle), try S-E (locked) */
+ mdbx_jitter4testing(false);
+ rc = flock(lfd, LCK_SHARED | LCK_DONTWAIT, LCK_LOWER) ? MDBX_RESULT_FALSE
+ : GetLastError();
+
+ mdbx_jitter4testing(false);
+ if (rc != MDBX_RESULT_FALSE)
+ mdbx_error("%s(%s) failed: errcode %u", __func__,
+ "?-E(middle) >> S-E(locked)", rc);
+
+ /* 8) now on S-E (locked) or still on ?-E (middle),
+ * transite to S-? (used) or ?-? (free) */
+ if (!funlock(lfd, LCK_UPPER))
+ mdbx_panic("%s(%s) failed: errcode %u", __func__,
+ "X-E(locked/middle) >> X-?(used/free)", GetLastError());
+
+ /* 9) now on S-? (used, DONE) or ?-? (free, FAILURE) */
+ return rc;
+}
+
+MDBX_INTERNAL_FUNC int mdbx_lck_seize(MDBX_env *env) {
+ int rc;
+
+ assert(env->me_fd != INVALID_HANDLE_VALUE);
+ if (env->me_flags & MDBX_EXCLUSIVE)
+ return MDBX_RESULT_TRUE /* nope since files were must be opened
+ non-shareable */
+ ;
+
+ if (env->me_lfd == INVALID_HANDLE_VALUE) {
+ /* LY: without-lck mode (e.g. on read-only filesystem) */
+ mdbx_jitter4testing(false);
+ if (!flock(env->me_fd, LCK_SHARED | LCK_DONTWAIT, LCK_WHOLE)) {
+ rc = GetLastError();
+ mdbx_error("%s(%s) failed: errcode %u", __func__, "without-lck", rc);
+ return rc;
+ }
+ return MDBX_RESULT_FALSE;
+ }
+
+ rc = internal_seize_lck(env->me_lfd);
+ mdbx_jitter4testing(false);
+ if (rc == MDBX_RESULT_TRUE && (env->me_flags & MDBX_RDONLY) == 0) {
+ /* Check that another process don't operates in without-lck mode.
+ * Doing such check by exclusive locking the body-part of db. Should be
+ * noted:
+ * - we need an exclusive lock for do so;
+ * - we can't lock meta-pages, otherwise other process could get an error
+ * while opening db in valid (non-conflict) mode. */
+ if (!flock(env->me_fd, LCK_EXCLUSIVE | LCK_DONTWAIT, LCK_BODY)) {
+ rc = GetLastError();
+ mdbx_error("%s(%s) failed: errcode %u", __func__,
+ "lock-against-without-lck", rc);
+ mdbx_jitter4testing(false);
+ lck_unlock(env);
+ } else {
+ mdbx_jitter4testing(false);
+ if (!funlock(env->me_fd, LCK_BODY))
+ mdbx_panic("%s(%s) failed: errcode %u", __func__,
+ "unlock-against-without-lck", GetLastError());
+ }
+ }
+
+ return rc;
+}
+
+MDBX_INTERNAL_FUNC int mdbx_lck_downgrade(MDBX_env *env) {
+ /* Transite from exclusive state (E-?) to used (S-?) */
+ assert(env->me_fd != INVALID_HANDLE_VALUE);
+ assert(env->me_lfd != INVALID_HANDLE_VALUE);
+
+#if 1
+ if (env->me_flags & MDBX_EXCLUSIVE)
+ return MDBX_SUCCESS /* nope since files were must be opened non-shareable */
+ ;
+#else
+ /* 1) must be at E-E (exclusive-write) */
+ if (env->me_flags & MDBX_EXCLUSIVE) {
+ /* transite from E-E to E_? (exclusive-read) */
+ if (!funlock(env->me_lfd, LCK_UPPER))
+ mdbx_panic("%s(%s) failed: errcode %u", __func__,
+ "E-E(exclusive-write) >> E-?(exclusive-read)", GetLastError());
+ return MDBX_SUCCESS /* 2) now at E-? (exclusive-read), done */;
+ }
+#endif
+
+ /* 3) now at E-E (exclusive-write), transite to ?_E (middle) */
+ if (!funlock(env->me_lfd, LCK_LOWER))
+ mdbx_panic("%s(%s) failed: errcode %u", __func__,
+ "E-E(exclusive-write) >> ?-E(middle)", GetLastError());
+
+ /* 4) now at ?-E (middle), transite to S-E (locked) */
+ if (!flock(env->me_lfd, LCK_SHARED | LCK_DONTWAIT, LCK_LOWER)) {
+ int rc = GetLastError() /* 5) something went wrong, give up */;
+ mdbx_error("%s(%s) failed: errcode %u", __func__,
+ "?-E(middle) >> S-E(locked)", rc);
+ return rc;
+ }
+
+ /* 6) got S-E (locked), continue transition to S-? (used) */
+ if (!funlock(env->me_lfd, LCK_UPPER))
+ mdbx_panic("%s(%s) failed: errcode %u", __func__,
+ "S-E(locked) >> S-?(used)", GetLastError());
+
+ return MDBX_SUCCESS /* 7) now at S-? (used), done */;
+}
+
+/*----------------------------------------------------------------------------*/
+/* reader checking (by pid) */
+
+MDBX_INTERNAL_FUNC int mdbx_rpid_set(MDBX_env *env) {
+ (void)env;
+ return MDBX_SUCCESS;
+}
+
+MDBX_INTERNAL_FUNC int mdbx_rpid_clear(MDBX_env *env) {
+ (void)env;
+ return MDBX_SUCCESS;
+}
+
+/* Checks reader by pid.
+ *
+ * Returns:
+ * MDBX_RESULT_TRUE, if pid is live (unable to acquire lock)
+ * MDBX_RESULT_FALSE, if pid is dead (lock acquired)
+ * or otherwise the errcode. */
+MDBX_INTERNAL_FUNC int mdbx_rpid_check(MDBX_env *env, uint32_t pid) {
+ (void)env;
+ HANDLE hProcess = OpenProcess(SYNCHRONIZE, FALSE, pid);
+ int rc;
+ if (likely(hProcess)) {
+ rc = WaitForSingleObject(hProcess, 0);
+ if (unlikely(rc == WAIT_FAILED))
+ rc = GetLastError();
+ CloseHandle(hProcess);
+ } else {
+ rc = GetLastError();
+ }
+
+ switch (rc) {
+ case ERROR_INVALID_PARAMETER:
+ /* pid seems invalid */
+ return MDBX_RESULT_FALSE;
+ case WAIT_OBJECT_0:
+ /* process just exited */
+ return MDBX_RESULT_FALSE;
+ case WAIT_TIMEOUT:
+ /* pid running */
+ return MDBX_RESULT_TRUE;
+ default:
+ /* failure */
+ return rc;
+ }
+}
+
+//----------------------------------------------------------------------------
+// Stub for slim read-write lock
+// Copyright (C) 1995-2002 Brad Wilson
+
+static void WINAPI stub_srwlock_Init(MDBX_srwlock *srwl) {
+ srwl->readerCount = srwl->writerCount = 0;
+}
+
+static void WINAPI stub_srwlock_AcquireShared(MDBX_srwlock *srwl) {
+ while (true) {
+ assert(srwl->writerCount >= 0 && srwl->readerCount >= 0);
+
+ // If there's a writer already, spin without unnecessarily
+ // interlocking the CPUs
+ if (srwl->writerCount != 0) {
+ YieldProcessor();
+ continue;
+ }
+
+ // Add to the readers list
+ _InterlockedIncrement(&srwl->readerCount);
+
+ // Check for writers again (we may have been pre-empted). If
+ // there are no writers writing or waiting, then we're done.
+ if (srwl->writerCount == 0)
+ break;
+
+ // Remove from the readers list, spin, try again
+ _InterlockedDecrement(&srwl->readerCount);
+ YieldProcessor();
+ }
+}
+
+static void WINAPI stub_srwlock_ReleaseShared(MDBX_srwlock *srwl) {
+ assert(srwl->readerCount > 0);
+ _InterlockedDecrement(&srwl->readerCount);
+}
+
+static void WINAPI stub_srwlock_AcquireExclusive(MDBX_srwlock *srwl) {
+ while (true) {
+ assert(srwl->writerCount >= 0 && srwl->readerCount >= 0);
+
+ // If there's a writer already, spin without unnecessarily
+ // interlocking the CPUs
+ if (srwl->writerCount != 0) {
+ YieldProcessor();
+ continue;
+ }
+
+ // See if we can become the writer (expensive, because it inter-
+ // locks the CPUs, so writing should be an infrequent process)
+ if (_InterlockedExchange(&srwl->writerCount, 1) == 0)
+ break;
+ }
+
+ // Now we're the writer, but there may be outstanding readers.
+ // Spin until there aren't any more; new readers will wait now
+ // that we're the writer.
+ while (srwl->readerCount != 0) {
+ assert(srwl->writerCount >= 0 && srwl->readerCount >= 0);
+ YieldProcessor();
+ }
+}
+
+static void WINAPI stub_srwlock_ReleaseExclusive(MDBX_srwlock *srwl) {
+ assert(srwl->writerCount == 1 && srwl->readerCount >= 0);
+ srwl->writerCount = 0;
+}
+
+MDBX_srwlock_function mdbx_srwlock_Init, mdbx_srwlock_AcquireShared,
+ mdbx_srwlock_ReleaseShared, mdbx_srwlock_AcquireExclusive,
+ mdbx_srwlock_ReleaseExclusive;
+
+/*----------------------------------------------------------------------------*/
+
+#if 0 /* LY: unused for now */
+static DWORD WINAPI stub_DiscardVirtualMemory(PVOID VirtualAddress,
+ SIZE_T Size) {
+ return VirtualAlloc(VirtualAddress, Size, MEM_RESET, PAGE_NOACCESS)
+ ? ERROR_SUCCESS
+ : GetLastError();
+}
+#endif /* unused for now */
+
+static uint64_t WINAPI stub_GetTickCount64(void) {
+ LARGE_INTEGER Counter, Frequency;
+ return (QueryPerformanceFrequency(&Frequency) &&
+ QueryPerformanceCounter(&Counter))
+ ? Counter.QuadPart * 1000ul / Frequency.QuadPart
+ : 0;
+}
+
+/*----------------------------------------------------------------------------*/
+#ifndef MDBX_ALLOY
+MDBX_GetFileInformationByHandleEx mdbx_GetFileInformationByHandleEx;
+MDBX_GetVolumeInformationByHandleW mdbx_GetVolumeInformationByHandleW;
+MDBX_GetFinalPathNameByHandleW mdbx_GetFinalPathNameByHandleW;
+MDBX_SetFileInformationByHandle mdbx_SetFileInformationByHandle;
+MDBX_NtFsControlFile mdbx_NtFsControlFile;
+MDBX_PrefetchVirtualMemory mdbx_PrefetchVirtualMemory;
+MDBX_GetTickCount64 mdbx_GetTickCount64;
+#if 0 /* LY: unused for now */
+MDBX_DiscardVirtualMemory mdbx_DiscardVirtualMemory;
+MDBX_OfferVirtualMemory mdbx_OfferVirtualMemory;
+MDBX_ReclaimVirtualMemory mdbx_ReclaimVirtualMemory;
+#endif /* unused for now */
+#endif /* MDBX_ALLOY */
+
+static void mdbx_winnt_import(void) {
+ const HINSTANCE hKernel32dll = GetModuleHandleA("kernel32.dll");
+ const MDBX_srwlock_function init =
+ (MDBX_srwlock_function)GetProcAddress(hKernel32dll, "InitializeSRWLock");
+ if (init != NULL) {
+ mdbx_srwlock_Init = init;
+ mdbx_srwlock_AcquireShared = (MDBX_srwlock_function)GetProcAddress(
+ hKernel32dll, "AcquireSRWLockShared");
+ mdbx_srwlock_ReleaseShared = (MDBX_srwlock_function)GetProcAddress(
+ hKernel32dll, "ReleaseSRWLockShared");
+ mdbx_srwlock_AcquireExclusive = (MDBX_srwlock_function)GetProcAddress(
+ hKernel32dll, "AcquireSRWLockExclusive");
+ mdbx_srwlock_ReleaseExclusive = (MDBX_srwlock_function)GetProcAddress(
+ hKernel32dll, "ReleaseSRWLockExclusive");
+ } else {
+ mdbx_srwlock_Init = stub_srwlock_Init;
+ mdbx_srwlock_AcquireShared = stub_srwlock_AcquireShared;
+ mdbx_srwlock_ReleaseShared = stub_srwlock_ReleaseShared;
+ mdbx_srwlock_AcquireExclusive = stub_srwlock_AcquireExclusive;
+ mdbx_srwlock_ReleaseExclusive = stub_srwlock_ReleaseExclusive;
+ }
+
+#define GET_KERNEL32_PROC(ENTRY) \
+ mdbx_##ENTRY = (MDBX_##ENTRY)GetProcAddress(hKernel32dll, #ENTRY)
+ GET_KERNEL32_PROC(GetFileInformationByHandleEx);
+ GET_KERNEL32_PROC(GetVolumeInformationByHandleW);
+ GET_KERNEL32_PROC(GetFinalPathNameByHandleW);
+ GET_KERNEL32_PROC(SetFileInformationByHandle);
+ GET_KERNEL32_PROC(PrefetchVirtualMemory);
+ GET_KERNEL32_PROC(GetTickCount64);
+ if (!mdbx_GetTickCount64)
+ mdbx_GetTickCount64 = stub_GetTickCount64;
+#if 0 /* LY: unused for now */
+ GET_KERNEL32_PROC(DiscardVirtualMemory);
+ if (!mdbx_DiscardVirtualMemory)
+ mdbx_DiscardVirtualMemory = stub_DiscardVirtualMemory;
+ GET_KERNEL32_PROC(OfferVirtualMemory);
+ GET_KERNEL32_PROC(ReclaimVirtualMemory);
+#endif /* unused for now */
+#undef GET_KERNEL32_PROC
+
+ const HINSTANCE hNtdll = GetModuleHandleA("ntdll.dll");
+ mdbx_NtFsControlFile =
+ (MDBX_NtFsControlFile)GetProcAddress(hNtdll, "NtFsControlFile");
+}
diff --git a/contrib/db/libmdbx/src/elements/ntdll.def b/contrib/db/libmdbx/src/elements/ntdll.def
new file mode 100644
index 00000000..e3a6e33c
--- /dev/null
+++ b/contrib/db/libmdbx/src/elements/ntdll.def
@@ -0,0 +1,1244 @@
+LIBRARY ntdll
+EXPORTS
+CsrAllocateCaptureBuffer
+CsrAllocateMessagePointer
+CsrCaptureMessageBuffer
+CsrCaptureMessageMultiUnicodeStringsInPlace
+CsrCaptureMessageString
+CsrCaptureTimeout
+CsrClientCallServer
+CsrClientConnectToServer
+CsrFreeCaptureBuffer
+CsrGetProcessId
+CsrIdentifyAlertableThread
+CsrSetPriorityClass
+DbgBreakPoint
+DbgPrint
+DbgPrintEx
+DbgPrintReturnControlC
+DbgPrompt
+DbgQueryDebugFilterState
+DbgSetDebugFilterState
+DbgUiConnectToDbg
+DbgUiContinue
+DbgUiConvertStateChangeStructure
+DbgUiDebugActiveProcess
+DbgUiGetThreadDebugObject
+DbgUiIssueRemoteBreakin
+DbgUiRemoteBreakin
+DbgUiSetThreadDebugObject
+DbgUiStopDebugging
+DbgUiWaitStateChange
+DbgUserBreakPoint
+KiRaiseUserExceptionDispatcher
+KiUserApcDispatcher
+KiUserCallbackDispatcher
+KiUserExceptionDispatcher
+LdrAccessResource
+LdrAddRefDll
+LdrDisableThreadCalloutsForDll
+LdrEnumResources
+LdrEnumerateLoadedModules
+LdrFindEntryForAddress
+LdrFindResourceDirectory_U
+LdrFindResourceEx_U
+LdrFindResource_U
+LdrFlushAlternateResourceModules
+LdrGetDllHandle
+LdrGetDllHandleEx
+LdrGetProcedureAddress
+LdrInitShimEngineDynamic
+LdrInitializeThunk
+LdrLoadAlternateResourceModule
+LdrLoadDll
+LdrLockLoaderLock
+LdrProcessRelocationBlock
+LdrQueryImageFileExecutionOptions
+LdrQueryProcessModuleInformation
+LdrSetAppCompatDllRedirectionCallback
+LdrSetDllManifestProber
+LdrShutdownProcess
+LdrShutdownThread
+LdrUnloadAlternateResourceModule
+LdrUnloadDll
+LdrUnlockLoaderLock
+LdrVerifyImageMatchesChecksum
+NlsAnsiCodePage
+NlsMbCodePageTag
+NlsMbOemCodePageTag
+NtAcceptConnectPort
+NtAccessCheck
+NtAccessCheckAndAuditAlarm
+NtAccessCheckByType
+NtAccessCheckByTypeAndAuditAlarm
+NtAccessCheckByTypeResultList
+NtAccessCheckByTypeResultListAndAuditAlarm
+NtAccessCheckByTypeResultListAndAuditAlarmByHandle
+NtAddAtom
+NtAddBootEntry
+NtAdjustGroupsToken
+NtAdjustPrivilegesToken
+NtAlertResumeThread
+NtAlertThread
+NtAllocateLocallyUniqueId
+NtAllocateUserPhysicalPages
+NtAllocateUuids
+NtAllocateVirtualMemory
+NtAreMappedFilesTheSame
+NtAssignProcessToJobObject
+NtCallbackReturn
+NtCancelIoFile
+NtCancelTimer
+NtClearEvent
+NtClose
+NtCloseObjectAuditAlarm
+NtCompactKeys
+NtCompareTokens
+NtCompleteConnectPort
+NtCompressKey
+NtConnectPort
+NtContinue
+NtCreateDebugObject
+NtCreateDirectoryObject
+NtCreateEvent
+NtCreateEventPair
+NtCreateFile
+NtCreateIoCompletion
+NtCreateJobObject
+NtCreateJobSet
+NtCreateKey
+NtCreateKeyedEvent
+NtCreateMailslotFile
+NtCreateMutant
+NtCreateNamedPipeFile
+NtCreatePagingFile
+NtCreatePort
+NtCreateProcess
+NtCreateProcessEx
+NtCreateProfile
+NtCreateSection
+NtCreateSemaphore
+NtCreateSymbolicLinkObject
+NtCreateThread
+NtCreateTimer
+NtCreateToken
+NtCreateWaitablePort
+NtDebugActiveProcess
+NtDebugContinue
+NtDelayExecution
+NtDeleteAtom
+NtDeleteBootEntry
+NtDeleteFile
+NtDeleteKey
+NtDeleteObjectAuditAlarm
+NtDeleteValueKey
+NtDeviceIoControlFile
+NtDisplayString
+NtDuplicateObject
+NtDuplicateToken
+NtEnumerateBootEntries
+NtEnumerateKey
+NtEnumerateSystemEnvironmentValuesEx
+NtEnumerateValueKey
+NtExtendSection
+NtFilterToken
+NtFindAtom
+NtFlushBuffersFile
+NtFlushInstructionCache
+NtFlushKey
+NtFlushVirtualMemory
+NtFlushWriteBuffer
+NtFreeUserPhysicalPages
+NtFreeVirtualMemory
+NtFsControlFile
+NtGetContextThread
+NtGetDevicePowerState
+NtGetWriteWatch
+NtImpersonateAnonymousToken
+NtImpersonateClientOfPort
+NtImpersonateThread
+NtInitializeRegistry
+NtInitiatePowerAction
+NtIsProcessInJob
+NtIsSystemResumeAutomatic
+NtListenPort
+NtLoadDriver
+NtLoadKey
+NtLoadKey2
+NtLockFile
+NtLockProductActivationKeys
+NtLockRegistryKey
+NtLockVirtualMemory
+NtMakePermanentObject
+NtMakeTemporaryObject
+NtMapUserPhysicalPages
+NtMapUserPhysicalPagesScatter
+NtMapViewOfSection
+NtModifyBootEntry
+NtNotifyChangeDirectoryFile
+NtNotifyChangeKey
+NtNotifyChangeMultipleKeys
+NtOpenDirectoryObject
+NtOpenEvent
+NtOpenEventPair
+NtOpenFile
+NtOpenIoCompletion
+NtOpenJobObject
+NtOpenKey
+NtOpenKeyedEvent
+NtOpenMutant
+NtOpenObjectAuditAlarm
+NtOpenProcess
+NtOpenProcessToken
+NtOpenProcessTokenEx
+NtOpenSection
+NtOpenSemaphore
+NtOpenSymbolicLinkObject
+NtOpenThread
+NtOpenThreadToken
+NtOpenThreadTokenEx
+NtOpenTimer
+NtPlugPlayControl
+NtPowerInformation
+NtPrivilegeCheck
+NtPrivilegeObjectAuditAlarm
+NtPrivilegedServiceAuditAlarm
+NtProtectVirtualMemory
+NtPulseEvent
+NtQueryAttributesFile
+NtQueryBootEntryOrder
+NtQueryBootOptions
+NtQueryDebugFilterState
+NtQueryDefaultLocale
+NtQueryDefaultUILanguage
+NtQueryDirectoryFile
+NtQueryDirectoryObject
+NtQueryEaFile
+NtQueryEvent
+NtQueryFullAttributesFile
+NtQueryInformationAtom
+NtQueryInformationFile
+NtQueryInformationJobObject
+NtQueryInformationPort
+NtQueryInformationProcess
+NtQueryInformationThread
+NtQueryInformationToken
+NtQueryInstallUILanguage
+NtQueryIntervalProfile
+NtQueryIoCompletion
+NtQueryKey
+NtQueryMultipleValueKey
+NtQueryMutant
+NtQueryObject
+NtQueryOpenSubKeys
+NtQueryPerformanceCounter
+NtQueryPortInformationProcess
+NtQueryQuotaInformationFile
+NtQuerySection
+NtQuerySecurityObject
+NtQuerySemaphore
+NtQuerySymbolicLinkObject
+NtQuerySystemEnvironmentValue
+NtQuerySystemEnvironmentValueEx
+NtQuerySystemInformation
+NtQuerySystemTime
+NtQueryTimer
+NtQueryTimerResolution
+NtQueryValueKey
+NtQueryVirtualMemory
+NtQueryVolumeInformationFile
+NtQueueApcThread
+NtRaiseException
+NtRaiseHardError
+NtReadFile
+NtReadFileScatter
+NtReadRequestData
+NtReadVirtualMemory
+NtRegisterThreadTerminatePort
+NtReleaseKeyedEvent
+NtReleaseMutant
+NtReleaseSemaphore
+NtRemoveIoCompletion
+NtRemoveProcessDebug
+NtRenameKey
+NtReplaceKey
+NtReplyPort
+NtReplyWaitReceivePort
+NtReplyWaitReceivePortEx
+NtReplyWaitReplyPort
+NtRequestPort
+NtRequestWaitReplyPort
+NtResetEvent
+NtResetWriteWatch
+NtRestoreKey
+NtResumeProcess
+NtResumeThread
+NtSaveKey
+NtSaveKeyEx
+NtSaveMergedKeys
+NtSecureConnectPort
+NtSetBootEntryOrder
+NtSetBootOptions
+NtSetContextThread
+NtSetDebugFilterState
+NtSetDefaultHardErrorPort
+NtSetDefaultLocale
+NtSetDefaultUILanguage
+NtSetEaFile
+NtSetEvent
+NtSetEventBoostPriority
+NtSetHighEventPair
+NtSetHighWaitLowEventPair
+NtSetInformationDebugObject
+NtSetInformationFile
+NtSetInformationJobObject
+NtSetInformationKey
+NtSetInformationObject
+NtSetInformationProcess
+NtSetInformationThread
+NtSetInformationToken
+NtSetIntervalProfile
+NtSetIoCompletion
+NtSetLdtEntries
+NtSetLowEventPair
+NtSetLowWaitHighEventPair
+NtSetQuotaInformationFile
+NtSetSecurityObject
+NtSetSystemEnvironmentValue
+NtSetSystemEnvironmentValueEx
+NtSetSystemInformation
+NtSetSystemPowerState
+NtSetSystemTime
+NtSetThreadExecutionState
+NtSetTimer
+NtSetTimerResolution
+NtSetUuidSeed
+NtSetValueKey
+NtSetVolumeInformationFile
+NtShutdownSystem
+NtSignalAndWaitForSingleObject
+NtStartProfile
+NtStopProfile
+NtSuspendProcess
+NtSuspendThread
+NtSystemDebugControl
+NtTerminateJobObject
+NtTerminateProcess
+NtTerminateThread
+NtTestAlert
+NtTraceEvent
+NtTranslateFilePath
+NtUnloadDriver
+NtUnloadKey
+NtUnloadKeyEx
+NtUnlockFile
+NtUnlockVirtualMemory
+NtUnmapViewOfSection
+NtVdmControl
+NtWaitForDebugEvent
+NtWaitForKeyedEvent
+NtWaitForMultipleObjects
+NtWaitForSingleObject
+NtWaitHighEventPair
+NtWaitLowEventPair
+NtWriteFile
+NtWriteFileGather
+NtWriteRequestData
+NtWriteVirtualMemory
+NtYieldExecution
+PfxFindPrefix
+PfxInitialize
+PfxInsertPrefix
+PfxRemovePrefix
+RtlAbortRXact
+RtlAbsoluteToSelfRelativeSD
+RtlAcquirePebLock
+RtlAcquireResourceExclusive
+RtlAcquireResourceShared
+RtlActivateActivationContext
+RtlActivateActivationContextEx
+RtlActivateActivationContextUnsafeFast
+RtlAddAccessAllowedAce
+RtlAddAccessAllowedAceEx
+RtlAddAccessAllowedObjectAce
+RtlAddAccessDeniedAce
+RtlAddAccessDeniedAceEx
+RtlAddAccessDeniedObjectAce
+RtlAddAce
+RtlAddActionToRXact
+RtlAddAtomToAtomTable
+RtlAddAttributeActionToRXact
+RtlAddAuditAccessAce
+RtlAddAuditAccessAceEx
+RtlAddAuditAccessObjectAce
+RtlAddCompoundAce
+RtlAddRefActivationContext
+RtlAddRefMemoryStream
+RtlAddVectoredExceptionHandler
+RtlAddressInSectionTable
+RtlAdjustPrivilege
+RtlAllocateAndInitializeSid
+RtlAllocateHandle
+RtlAllocateHeap
+RtlAnsiCharToUnicodeChar
+RtlAnsiStringToUnicodeSize
+RtlAnsiStringToUnicodeString
+RtlAppendAsciizToString
+RtlAppendPathElement
+RtlAppendStringToString
+RtlAppendUnicodeStringToString
+RtlAppendUnicodeToString
+RtlApplicationVerifierStop
+RtlApplyRXact
+RtlApplyRXactNoFlush
+RtlAreAllAccessesGranted
+RtlAreAnyAccessesGranted
+RtlAreBitsClear
+RtlAreBitsSet
+RtlAssert
+RtlCancelTimer
+RtlCaptureContext
+RtlCaptureStackBackTrace
+RtlCharToInteger
+RtlCheckForOrphanedCriticalSections
+RtlCheckRegistryKey
+RtlClearAllBits
+RtlClearBits
+RtlCloneMemoryStream
+RtlCommitMemoryStream
+RtlCompactHeap
+RtlCompareMemory
+RtlCompareMemoryUlong
+RtlCompareString
+RtlCompareUnicodeString
+RtlCompressBuffer
+RtlComputeCrc32
+RtlComputeImportTableHash
+RtlComputePrivatizedDllName_U
+RtlConsoleMultiByteToUnicodeN
+RtlConvertExclusiveToShared
+RtlConvertSharedToExclusive
+RtlConvertSidToUnicodeString
+RtlConvertToAutoInheritSecurityObject
+RtlCopyLuid
+RtlCopyLuidAndAttributesArray
+RtlCopyMemoryStreamTo
+RtlCopyOutOfProcessMemoryStreamTo
+RtlCopySecurityDescriptor
+RtlCopySid
+RtlCopySidAndAttributesArray
+RtlCopyString
+RtlCopyUnicodeString
+RtlCreateAcl
+RtlCreateActivationContext
+RtlCreateAndSetSD
+RtlCreateAtomTable
+RtlCreateBootStatusDataFile
+RtlCreateEnvironment
+RtlCreateHeap
+RtlCreateProcessParameters
+RtlCreateQueryDebugBuffer
+RtlCreateRegistryKey
+RtlCreateSecurityDescriptor
+RtlCreateServiceSid
+RtlCreateSystemVolumeInformationFolder
+RtlCreateTagHeap
+RtlCreateTimer
+RtlCreateTimerQueue
+RtlCreateUnicodeString
+RtlCreateUnicodeStringFromAsciiz
+RtlCreateUserProcess
+RtlCreateUserSecurityObject
+RtlCreateUserThread
+RtlCustomCPToUnicodeN
+RtlCutoverTimeToSystemTime
+RtlDeNormalizeProcessParams
+RtlDeactivateActivationContext
+RtlDeactivateActivationContextUnsafeFast
+RtlDebugPrintTimes
+RtlDecodePointer
+RtlDecodeSystemPointer
+RtlDecompressBuffer
+RtlDecompressFragment
+RtlDefaultNpAcl
+RtlDelete
+RtlDeleteAce
+RtlDeleteAtomFromAtomTable
+RtlDeleteCriticalSection
+RtlDeleteElementGenericTable
+RtlDeleteElementGenericTableAvl
+RtlDeleteNoSplay
+RtlDeleteRegistryValue
+RtlDeleteResource
+RtlDeleteSecurityObject
+RtlDeleteTimer
+RtlDeleteTimerQueue
+RtlDeleteTimerQueueEx
+RtlDeregisterWait
+RtlDeregisterWaitEx
+RtlDestroyAtomTable
+RtlDestroyEnvironment
+RtlDestroyHandleTable
+RtlDestroyHeap
+RtlDestroyProcessParameters
+RtlDestroyQueryDebugBuffer
+RtlDetermineDosPathNameType_U
+RtlDllShutdownInProgress
+RtlDnsHostNameToComputerName
+RtlDoesFileExists_U
+RtlDosApplyFileIsolationRedirection_Ustr
+RtlDosPathNameToNtPathName_U
+RtlDosSearchPath_U
+RtlDosSearchPath_Ustr
+RtlDowncaseUnicodeChar
+RtlDowncaseUnicodeString
+RtlDumpResource
+RtlDuplicateUnicodeString
+RtlEmptyAtomTable
+RtlEnableEarlyCriticalSectionEventCreation
+RtlEncodePointer
+RtlEncodeSystemPointer
+RtlEnterCriticalSection
+RtlEnumProcessHeaps
+RtlEnumerateGenericTable
+RtlEnumerateGenericTableAvl
+RtlEnumerateGenericTableLikeADirectory
+RtlEnumerateGenericTableWithoutSplaying
+RtlEnumerateGenericTableWithoutSplayingAvl
+RtlEqualComputerName
+RtlEqualDomainName
+RtlEqualLuid
+RtlEqualPrefixSid
+RtlEqualSid
+RtlEqualString
+RtlEqualUnicodeString
+RtlEraseUnicodeString
+RtlExitUserThread
+RtlExpandEnvironmentStrings_U
+RtlFillMemory
+RtlFinalReleaseOutOfProcessMemoryStream
+RtlFindActivationContextSectionGuid
+RtlFindActivationContextSectionString
+RtlFindCharInUnicodeString
+RtlFindClearBits
+RtlFindClearBitsAndSet
+RtlFindClearRuns
+RtlFindLastBackwardRunClear
+RtlFindLeastSignificantBit
+RtlFindLongestRunClear
+RtlFindMessage
+RtlFindMostSignificantBit
+RtlFindNextForwardRunClear
+RtlFindSetBits
+RtlFindSetBitsAndClear
+RtlFirstEntrySList
+RtlFirstFreeAce
+RtlFlushSecureMemoryCache
+RtlFormatCurrentUserKeyPath
+RtlFormatMessage
+RtlFreeAnsiString
+RtlFreeHandle
+RtlFreeHeap
+RtlFreeOemString
+RtlFreeSid
+RtlFreeThreadActivationContextStack
+RtlFreeUnicodeString
+RtlGUIDFromString
+RtlGenerate8dot3Name
+RtlGetAce
+RtlGetActiveActivationContext
+RtlGetCallersAddress
+RtlGetCompressionWorkSpaceSize
+RtlGetControlSecurityDescriptor
+RtlGetCurrentDirectory_U
+RtlGetCurrentPeb
+RtlGetDaclSecurityDescriptor
+RtlGetElementGenericTable
+RtlGetElementGenericTableAvl
+RtlGetFrame
+RtlGetFullPathName_U
+RtlGetGroupSecurityDescriptor
+RtlGetLastNtStatus
+RtlGetLastWin32Error
+RtlGetLengthWithoutLastFullDosOrNtPathElement
+RtlGetLengthWithoutTrailingPathSeperators
+RtlGetLongestNtPathLength
+RtlGetNativeSystemInformation
+RtlGetNtGlobalFlags
+RtlGetNtProductType
+RtlGetNtVersionNumbers
+RtlGetOwnerSecurityDescriptor
+RtlGetProcessHeaps
+RtlGetSaclSecurityDescriptor
+RtlGetSecurityDescriptorRMControl
+RtlGetSetBootStatusData
+RtlGetUnloadEventTrace
+RtlGetUserInfoHeap
+RtlGetVersion
+RtlHashUnicodeString
+RtlIdentifierAuthoritySid
+RtlImageDirectoryEntryToData
+RtlImageNtHeader
+RtlImageRvaToSection
+RtlImageRvaToVa
+RtlImpersonateSelf
+RtlInitAnsiString
+RtlInitCodePageTable
+RtlInitMemoryStream
+RtlInitNlsTables
+RtlInitOutOfProcessMemoryStream
+RtlInitString
+RtlInitUnicodeString
+RtlInitUnicodeStringEx
+RtlInitializeAtomPackage
+RtlInitializeBitMap
+RtlInitializeContext
+RtlInitializeCriticalSection
+RtlInitializeCriticalSectionAndSpinCount
+RtlInitializeGenericTable
+RtlInitializeGenericTableAvl
+RtlInitializeHandleTable
+RtlInitializeRXact
+RtlInitializeResource
+RtlInitializeSListHead
+RtlInitializeSid
+RtlInsertElementGenericTable
+RtlInsertElementGenericTableAvl
+RtlInt64ToUnicodeString
+RtlIntegerToChar
+RtlIntegerToUnicodeString
+RtlInterlockedFlushSList
+RtlInterlockedPopEntrySList
+RtlInterlockedPushEntrySList
+RtlInterlockedPushListSList
+RtlIpv4AddressToStringA
+RtlIpv4AddressToStringExA
+RtlIpv4AddressToStringExW
+RtlIpv4AddressToStringW
+RtlIpv4StringToAddressA
+RtlIpv4StringToAddressExA
+RtlIpv4StringToAddressExW
+RtlIpv4StringToAddressW
+RtlIpv6AddressToStringA
+RtlIpv6AddressToStringExA
+RtlIpv6AddressToStringExW
+RtlIpv6AddressToStringW
+RtlIpv6StringToAddressA
+RtlIpv6StringToAddressExA
+RtlIpv6StringToAddressExW
+RtlIpv6StringToAddressW
+RtlIsActivationContextActive
+RtlIsDosDeviceName_U
+RtlIsGenericTableEmpty
+RtlIsGenericTableEmptyAvl
+RtlIsNameLegalDOS8Dot3
+RtlIsTextUnicode
+RtlIsThreadWithinLoaderCallout
+RtlIsValidHandle
+RtlIsValidIndexHandle
+RtlLargeIntegerToChar
+RtlLeaveCriticalSection
+RtlLengthRequiredSid
+RtlLengthSecurityDescriptor
+RtlLengthSid
+RtlLocalTimeToSystemTime
+RtlLockBootStatusData
+RtlLockHeap
+RtlLockMemoryStreamRegion
+RtlLogStackBackTrace
+RtlLookupAtomInAtomTable
+RtlLookupElementGenericTable
+RtlLookupElementGenericTableAvl
+RtlMakeSelfRelativeSD
+RtlMapGenericMask
+RtlMapSecurityErrorToNtStatus
+RtlMoveMemory
+RtlMultiAppendUnicodeStringBuffer
+RtlMultiByteToUnicodeN
+RtlMultiByteToUnicodeSize
+RtlNewInstanceSecurityObject
+RtlNewSecurityGrantedAccess
+RtlNewSecurityObject
+RtlNewSecurityObjectEx
+RtlNewSecurityObjectWithMultipleInheritance
+RtlNormalizeProcessParams
+RtlNtPathNameToDosPathName
+RtlNtStatusToDosError
+RtlNtStatusToDosErrorNoTeb
+RtlNumberGenericTableElements
+RtlNumberGenericTableElementsAvl
+RtlNumberOfClearBits
+RtlNumberOfSetBits
+RtlOemStringToUnicodeSize
+RtlOemStringToUnicodeString
+RtlOemToUnicodeN
+RtlOpenCurrentUser
+RtlPcToFileHeader
+RtlPinAtomInAtomTable
+RtlPopFrame
+RtlPrefixString
+RtlPrefixUnicodeString
+RtlProtectHeap
+RtlPushFrame
+RtlQueryAtomInAtomTable
+RtlQueryDepthSList
+RtlQueryEnvironmentVariable_U
+RtlQueryHeapInformation
+RtlQueryInformationAcl
+RtlQueryInformationActivationContext
+RtlQueryInformationActiveActivationContext
+RtlQueryInterfaceMemoryStream
+RtlQueryProcessBackTraceInformation
+RtlQueryProcessDebugInformation
+RtlQueryProcessHeapInformation
+RtlQueryProcessLockInformation
+RtlQueryRegistryValues
+RtlQuerySecurityObject
+RtlQueryTagHeap
+RtlQueryTimeZoneInformation
+RtlQueueApcWow64Thread
+RtlQueueWorkItem
+RtlRaiseException
+RtlRaiseStatus
+RtlRandom
+RtlRandomEx
+RtlReAllocateHeap
+RtlReadMemoryStream
+RtlReadOutOfProcessMemoryStream
+RtlRealPredecessor
+RtlRealSuccessor
+RtlRegisterSecureMemoryCacheCallback
+RtlRegisterWait
+RtlReleaseActivationContext
+RtlReleaseMemoryStream
+RtlReleasePebLock
+RtlReleaseResource
+RtlRemoteCall
+RtlRemoveVectoredExceptionHandler
+RtlResetRtlTranslations
+RtlRestoreLastWin32Error
+RtlRevertMemoryStream
+RtlRunDecodeUnicodeString
+RtlRunEncodeUnicodeString
+RtlSecondsSince1970ToTime
+RtlSecondsSince1980ToTime
+RtlSeekMemoryStream
+RtlSelfRelativeToAbsoluteSD
+RtlSelfRelativeToAbsoluteSD2
+RtlSetAllBits
+RtlSetAttributesSecurityDescriptor
+RtlSetBits
+RtlSetControlSecurityDescriptor
+RtlSetCriticalSectionSpinCount
+RtlSetCurrentDirectory_U
+RtlSetCurrentEnvironment
+RtlSetDaclSecurityDescriptor
+RtlSetEnvironmentVariable
+RtlSetGroupSecurityDescriptor
+RtlSetHeapInformation
+RtlSetInformationAcl
+RtlSetIoCompletionCallback
+RtlSetLastWin32Error
+RtlSetLastWin32ErrorAndNtStatusFromNtStatus
+RtlSetMemoryStreamSize
+RtlSetOwnerSecurityDescriptor
+RtlSetProcessIsCritical
+RtlSetSaclSecurityDescriptor
+RtlSetSecurityDescriptorRMControl
+RtlSetSecurityObject
+RtlSetSecurityObjectEx
+RtlSetThreadIsCritical
+RtlSetThreadPoolStartFunc
+RtlSetTimeZoneInformation
+RtlSetTimer
+RtlSetUserFlagsHeap
+RtlSetUserValueHeap
+RtlSizeHeap
+RtlSplay
+RtlStartRXact
+RtlStatMemoryStream
+RtlStringFromGUID
+RtlSubAuthorityCountSid
+RtlSubAuthoritySid
+RtlSubtreePredecessor
+RtlSubtreeSuccessor
+RtlSystemTimeToLocalTime
+RtlTimeFieldsToTime
+RtlTimeToElapsedTimeFields
+RtlTimeToSecondsSince1970
+RtlTimeToSecondsSince1980
+RtlTimeToTimeFields
+RtlTraceDatabaseAdd
+RtlTraceDatabaseCreate
+RtlTraceDatabaseDestroy
+RtlTraceDatabaseEnumerate
+RtlTraceDatabaseFind
+RtlTraceDatabaseLock
+RtlTraceDatabaseUnlock
+RtlTraceDatabaseValidate
+RtlTryEnterCriticalSection
+RtlUnhandledExceptionFilter
+RtlUnhandledExceptionFilter2
+RtlUnicodeStringToAnsiSize
+RtlUnicodeStringToAnsiString
+RtlUnicodeStringToCountedOemString
+RtlUnicodeStringToInteger
+RtlUnicodeStringToOemSize
+RtlUnicodeStringToOemString
+RtlUnicodeToCustomCPN
+RtlUnicodeToMultiByteN
+RtlUnicodeToMultiByteSize
+RtlUnicodeToOemN
+RtlUniform
+RtlUnlockBootStatusData
+RtlUnlockHeap
+RtlUnlockMemoryStreamRegion
+RtlUnwind
+RtlUpcaseUnicodeChar
+RtlUpcaseUnicodeString
+RtlUpcaseUnicodeStringToAnsiString
+RtlUpcaseUnicodeStringToCountedOemString
+RtlUpcaseUnicodeStringToOemString
+RtlUpcaseUnicodeToCustomCPN
+RtlUpcaseUnicodeToMultiByteN
+RtlUpcaseUnicodeToOemN
+RtlUpdateTimer
+RtlUpperChar
+RtlUpperString
+RtlValidAcl
+RtlValidRelativeSecurityDescriptor
+RtlValidSecurityDescriptor
+RtlValidSid
+RtlValidateHeap
+RtlValidateProcessHeaps
+RtlValidateUnicodeString
+RtlVerifyVersionInfo
+RtlWalkFrameChain
+RtlWalkHeap
+RtlWriteMemoryStream
+RtlWriteRegistryValue
+RtlZeroHeap
+RtlZeroMemory
+RtlZombifyActivationContext
+RtlpApplyLengthFunction
+RtlpEnsureBufferSize
+RtlpNotOwnerCriticalSection
+RtlpNtCreateKey
+RtlpNtEnumerateSubKey
+RtlpNtMakeTemporaryKey
+RtlpNtOpenKey
+RtlpNtQueryValueKey
+RtlpNtSetValueKey
+RtlpUnWaitCriticalSection
+RtlpWaitForCriticalSection
+RtlxAnsiStringToUnicodeSize
+RtlxOemStringToUnicodeSize
+RtlxUnicodeStringToAnsiSize
+RtlxUnicodeStringToOemSize
+VerSetConditionMask
+ZwAcceptConnectPort
+ZwAccessCheck
+ZwAccessCheckAndAuditAlarm
+ZwAccessCheckByType
+ZwAccessCheckByTypeAndAuditAlarm
+ZwAccessCheckByTypeResultList
+ZwAccessCheckByTypeResultListAndAuditAlarm
+ZwAccessCheckByTypeResultListAndAuditAlarmByHandle
+ZwAddAtom
+ZwAddBootEntry
+ZwAdjustGroupsToken
+ZwAdjustPrivilegesToken
+ZwAlertResumeThread
+ZwAlertThread
+ZwAllocateLocallyUniqueId
+ZwAllocateUserPhysicalPages
+ZwAllocateUuids
+ZwAllocateVirtualMemory
+ZwAreMappedFilesTheSame
+ZwAssignProcessToJobObject
+ZwCallbackReturn
+ZwCancelIoFile
+ZwCancelTimer
+ZwClearEvent
+ZwClose
+ZwCloseObjectAuditAlarm
+ZwCompactKeys
+ZwCompareTokens
+ZwCompleteConnectPort
+ZwCompressKey
+ZwConnectPort
+ZwContinue
+ZwCreateDebugObject
+ZwCreateDirectoryObject
+ZwCreateEvent
+ZwCreateEventPair
+ZwCreateFile
+ZwCreateIoCompletion
+ZwCreateJobObject
+ZwCreateJobSet
+ZwCreateKey
+ZwCreateKeyedEvent
+ZwCreateMailslotFile
+ZwCreateMutant
+ZwCreateNamedPipeFile
+ZwCreatePagingFile
+ZwCreatePort
+ZwCreateProcess
+ZwCreateProcessEx
+ZwCreateProfile
+ZwCreateSection
+ZwCreateSemaphore
+ZwCreateSymbolicLinkObject
+ZwCreateThread
+ZwCreateTimer
+ZwCreateToken
+ZwCreateWaitablePort
+ZwDebugActiveProcess
+ZwDebugContinue
+ZwDelayExecution
+ZwDeleteAtom
+ZwDeleteBootEntry
+ZwDeleteFile
+ZwDeleteKey
+ZwDeleteObjectAuditAlarm
+ZwDeleteValueKey
+ZwDeviceIoControlFile
+ZwDisplayString
+ZwDuplicateObject
+ZwDuplicateToken
+ZwEnumerateBootEntries
+ZwEnumerateKey
+ZwEnumerateSystemEnvironmentValuesEx
+ZwEnumerateValueKey
+ZwExtendSection
+ZwFilterToken
+ZwFindAtom
+ZwFlushBuffersFile
+ZwFlushInstructionCache
+ZwFlushKey
+ZwFlushVirtualMemory
+ZwFlushWriteBuffer
+ZwFreeUserPhysicalPages
+ZwFreeVirtualMemory
+ZwFsControlFile
+ZwGetContextThread
+ZwGetDevicePowerState
+ZwGetWriteWatch
+ZwImpersonateAnonymousToken
+ZwImpersonateClientOfPort
+ZwImpersonateThread
+ZwInitializeRegistry
+ZwInitiatePowerAction
+ZwIsProcessInJob
+ZwIsSystemResumeAutomatic
+ZwListenPort
+ZwLoadDriver
+ZwLoadKey
+ZwLoadKey2
+ZwLockFile
+ZwLockProductActivationKeys
+ZwLockRegistryKey
+ZwLockVirtualMemory
+ZwMakePermanentObject
+ZwMakeTemporaryObject
+ZwMapUserPhysicalPages
+ZwMapUserPhysicalPagesScatter
+ZwMapViewOfSection
+ZwModifyBootEntry
+ZwNotifyChangeDirectoryFile
+ZwNotifyChangeKey
+ZwNotifyChangeMultipleKeys
+ZwOpenDirectoryObject
+ZwOpenEvent
+ZwOpenEventPair
+ZwOpenFile
+ZwOpenIoCompletion
+ZwOpenJobObject
+ZwOpenKey
+ZwOpenKeyedEvent
+ZwOpenMutant
+ZwOpenObjectAuditAlarm
+ZwOpenProcess
+ZwOpenProcessToken
+ZwOpenProcessTokenEx
+ZwOpenSection
+ZwOpenSemaphore
+ZwOpenSymbolicLinkObject
+ZwOpenThread
+ZwOpenThreadToken
+ZwOpenThreadTokenEx
+ZwOpenTimer
+ZwPlugPlayControl
+ZwPowerInformation
+ZwPrivilegeCheck
+ZwPrivilegeObjectAuditAlarm
+ZwPrivilegedServiceAuditAlarm
+ZwProtectVirtualMemory
+ZwPulseEvent
+ZwQueryAttributesFile
+ZwQueryBootEntryOrder
+ZwQueryBootOptions
+ZwQueryDebugFilterState
+ZwQueryDefaultLocale
+ZwQueryDefaultUILanguage
+ZwQueryDirectoryFile
+ZwQueryDirectoryObject
+ZwQueryEaFile
+ZwQueryEvent
+ZwQueryFullAttributesFile
+ZwQueryInformationAtom
+ZwQueryInformationFile
+ZwQueryInformationJobObject
+ZwQueryInformationPort
+ZwQueryInformationProcess
+ZwQueryInformationThread
+ZwQueryInformationToken
+ZwQueryInstallUILanguage
+ZwQueryIntervalProfile
+ZwQueryIoCompletion
+ZwQueryKey
+ZwQueryMultipleValueKey
+ZwQueryMutant
+ZwQueryObject
+ZwQueryOpenSubKeys
+ZwQueryPerformanceCounter
+ZwQueryPortInformationProcess
+ZwQueryQuotaInformationFile
+ZwQuerySection
+ZwQuerySecurityObject
+ZwQuerySemaphore
+ZwQuerySymbolicLinkObject
+ZwQuerySystemEnvironmentValue
+ZwQuerySystemEnvironmentValueEx
+ZwQuerySystemInformation
+ZwQuerySystemTime
+ZwQueryTimer
+ZwQueryTimerResolution
+ZwQueryValueKey
+ZwQueryVirtualMemory
+ZwQueryVolumeInformationFile
+ZwQueueApcThread
+ZwRaiseException
+ZwRaiseHardError
+ZwReadFile
+ZwReadFileScatter
+ZwReadRequestData
+ZwReadVirtualMemory
+ZwRegisterThreadTerminatePort
+ZwReleaseKeyedEvent
+ZwReleaseMutant
+ZwReleaseSemaphore
+ZwRemoveIoCompletion
+ZwRemoveProcessDebug
+ZwRenameKey
+ZwReplaceKey
+ZwReplyPort
+ZwReplyWaitReceivePort
+ZwReplyWaitReceivePortEx
+ZwReplyWaitReplyPort
+ZwRequestPort
+ZwRequestWaitReplyPort
+ZwResetEvent
+ZwResetWriteWatch
+ZwRestoreKey
+ZwResumeProcess
+ZwResumeThread
+ZwSaveKey
+ZwSaveKeyEx
+ZwSaveMergedKeys
+ZwSecureConnectPort
+ZwSetBootEntryOrder
+ZwSetBootOptions
+ZwSetContextThread
+ZwSetDebugFilterState
+ZwSetDefaultHardErrorPort
+ZwSetDefaultLocale
+ZwSetDefaultUILanguage
+ZwSetEaFile
+ZwSetEvent
+ZwSetEventBoostPriority
+ZwSetHighEventPair
+ZwSetHighWaitLowEventPair
+ZwSetInformationDebugObject
+ZwSetInformationFile
+ZwSetInformationJobObject
+ZwSetInformationKey
+ZwSetInformationObject
+ZwSetInformationProcess
+ZwSetInformationThread
+ZwSetInformationToken
+ZwSetIntervalProfile
+ZwSetIoCompletion
+ZwSetLdtEntries
+ZwSetLowEventPair
+ZwSetLowWaitHighEventPair
+ZwSetQuotaInformationFile
+ZwSetSecurityObject
+ZwSetSystemEnvironmentValue
+ZwSetSystemEnvironmentValueEx
+ZwSetSystemInformation
+ZwSetSystemPowerState
+ZwSetSystemTime
+ZwSetThreadExecutionState
+ZwSetTimer
+ZwSetTimerResolution
+ZwSetUuidSeed
+ZwSetValueKey
+ZwSetVolumeInformationFile
+ZwShutdownSystem
+ZwSignalAndWaitForSingleObject
+ZwStartProfile
+ZwStopProfile
+ZwSuspendProcess
+ZwSuspendThread
+ZwSystemDebugControl
+ZwTerminateJobObject
+ZwTerminateProcess
+ZwTerminateThread
+ZwTestAlert
+ZwTraceEvent
+ZwTranslateFilePath
+ZwUnloadDriver
+ZwUnloadKey
+ZwUnloadKeyEx
+ZwUnlockFile
+ZwUnlockVirtualMemory
+ZwUnmapViewOfSection
+ZwVdmControl
+ZwWaitForDebugEvent
+ZwWaitForKeyedEvent
+ZwWaitForMultipleObjects
+ZwWaitForSingleObject
+ZwWaitHighEventPair
+ZwWaitLowEventPair
+ZwWriteFile
+ZwWriteFileGather
+ZwWriteRequestData
+ZwWriteVirtualMemory
+ZwYieldExecution
+__isascii
+__iscsym
+__iscsymf
+__toascii
+_alldiv
+_alldvrm
+_allmul
+_allrem
+_allshl
+_allshr
+_atoi64
+_aulldiv
+_aulldvrm
+_aullrem
+_aullshr
+_fltused
+_i64toa
+_i64tow
+_itoa
+_itow
+_lfind
+_ltoa
+_ltow
+_memccpy
+_memicmp
+_snprintf
+_snwprintf
+_splitpath
+_strcmpi
+_stricmp
+_strlwr
+_strnicmp
+_strupr
+_ui64toa
+_ui64tow
+_ultoa
+_ultow
+_vsnprintf
+_vsnwprintf
+_wcsicmp
+_wcslwr
+_wcsnicmp
+_wcsupr
+_wtoi
+_wtoi64
+_wtol
+abs
+atan
+atoi
+atol
+bsearch
+ceil
+cos
+fabs
+floor
+isalnum
+isalpha
+iscntrl
+isdigit
+isgraph
+islower
+isprint
+ispunct
+isspace
+isupper
+iswalpha
+iswctype
+iswdigit
+iswlower
+iswspace
+iswxdigit
+isxdigit
+labs
+log
+mbstowcs
+memchr
+memcmp
+memcpy
+memmove
+memset
+pow
+qsort
+sin
+sprintf
+sqrt
+sscanf
+strcat
+strchr
+strcmp
+strcpy
+strcspn
+strlen
+strncat
+strncmp
+strncpy
+strpbrk
+strrchr
+strspn
+strstr
+strtol
+strtoul
+swprintf
+tan
+tolower
+toupper
+towlower
+towupper
+vDbgPrintEx
+vDbgPrintExWithPrefix
+vsprintf
+wcscat
+wcschr
+wcscmp
+wcscpy
+wcscspn
+wcslen
+wcsncat
+wcsncmp
+wcsncpy
+wcspbrk
+wcsrchr
+wcsspn
+wcsstr
+wcstol
+wcstombs
+wcstoul
diff --git a/contrib/db/libmdbx/src/elements/osal.c b/contrib/db/libmdbx/src/elements/osal.c
new file mode 100644
index 00000000..9f13d510
--- /dev/null
+++ b/contrib/db/libmdbx/src/elements/osal.c
@@ -0,0 +1,1899 @@
+/* https://en.wikipedia.org/wiki/Operating_system_abstraction_layer */
+
+/*
+ * Copyright 2015-2019 Leonid Yuriev
+ * and other libmdbx authors: please see AUTHORS file.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted only as authorized by the OpenLDAP
+ * Public License.
+ *
+ * A copy of this license is available in the file LICENSE in the
+ * top-level directory of the distribution or, alternatively, at
+ * .
+ */
+
+#include "internals.h"
+
+#if defined(_WIN32) || defined(_WIN64)
+
+#include
+
+static int waitstatus2errcode(DWORD result) {
+ switch (result) {
+ case WAIT_OBJECT_0:
+ return MDBX_SUCCESS;
+ case WAIT_FAILED:
+ return GetLastError();
+ case WAIT_ABANDONED:
+ return ERROR_ABANDONED_WAIT_0;
+ case WAIT_IO_COMPLETION:
+ return ERROR_USER_APC;
+ case WAIT_TIMEOUT:
+ return ERROR_TIMEOUT;
+ default:
+ return ERROR_UNHANDLED_ERROR;
+ }
+}
+
+/* Map a result from an NTAPI call to WIN32 error code. */
+static int ntstatus2errcode(NTSTATUS status) {
+ DWORD dummy;
+ OVERLAPPED ov;
+ memset(&ov, 0, sizeof(ov));
+ ov.Internal = status;
+ return GetOverlappedResult(NULL, &ov, &dummy, FALSE) ? MDBX_SUCCESS
+ : GetLastError();
+}
+
+/* We use native NT APIs to setup the memory map, so that we can
+ * let the DB file grow incrementally instead of always preallocating
+ * the full size. These APIs are defined in and
+ * but those headers are meant for driver-level development and
+ * conflict with the regular user-level headers, so we explicitly
+ * declare them here. Using these APIs also means we must link to
+ * ntdll.dll, which is not linked by default in user code. */
+
+extern NTSTATUS NTAPI NtCreateSection(
+ OUT PHANDLE SectionHandle, IN ACCESS_MASK DesiredAccess,
+ IN OPTIONAL POBJECT_ATTRIBUTES ObjectAttributes,
+ IN OPTIONAL PLARGE_INTEGER MaximumSize, IN ULONG SectionPageProtection,
+ IN ULONG AllocationAttributes, IN OPTIONAL HANDLE FileHandle);
+
+typedef struct _SECTION_BASIC_INFORMATION {
+ ULONG Unknown;
+ ULONG SectionAttributes;
+ LARGE_INTEGER SectionSize;
+} SECTION_BASIC_INFORMATION, *PSECTION_BASIC_INFORMATION;
+
+typedef enum _SECTION_INFORMATION_CLASS {
+ SectionBasicInformation,
+ SectionImageInformation,
+ SectionRelocationInformation, // name:wow64:whNtQuerySection_SectionRelocationInformation
+ MaxSectionInfoClass
+} SECTION_INFORMATION_CLASS;
+
+extern NTSTATUS NTAPI NtQuerySection(
+ IN HANDLE SectionHandle, IN SECTION_INFORMATION_CLASS InformationClass,
+ OUT PVOID InformationBuffer, IN ULONG InformationBufferSize,
+ OUT PULONG ResultLength OPTIONAL);
+
+extern NTSTATUS NTAPI NtExtendSection(IN HANDLE SectionHandle,
+ IN PLARGE_INTEGER NewSectionSize);
+
+typedef enum _SECTION_INHERIT { ViewShare = 1, ViewUnmap = 2 } SECTION_INHERIT;
+
+extern NTSTATUS NTAPI NtMapViewOfSection(
+ IN HANDLE SectionHandle, IN HANDLE ProcessHandle, IN OUT PVOID *BaseAddress,
+ IN ULONG_PTR ZeroBits, IN SIZE_T CommitSize,
+ IN OUT OPTIONAL PLARGE_INTEGER SectionOffset, IN OUT PSIZE_T ViewSize,
+ IN SECTION_INHERIT InheritDisposition, IN ULONG AllocationType,
+ IN ULONG Win32Protect);
+
+extern NTSTATUS NTAPI NtUnmapViewOfSection(IN HANDLE ProcessHandle,
+ IN OPTIONAL PVOID BaseAddress);
+
+extern NTSTATUS NTAPI NtClose(HANDLE Handle);
+
+extern NTSTATUS NTAPI NtAllocateVirtualMemory(
+ IN HANDLE ProcessHandle, IN OUT PVOID *BaseAddress, IN ULONG_PTR ZeroBits,
+ IN OUT PSIZE_T RegionSize, IN ULONG AllocationType, IN ULONG Protect);
+
+extern NTSTATUS NTAPI NtFreeVirtualMemory(IN HANDLE ProcessHandle,
+ IN PVOID *BaseAddress,
+ IN OUT PSIZE_T RegionSize,
+ IN ULONG FreeType);
+
+#ifndef WOF_CURRENT_VERSION
+typedef struct _WOF_EXTERNAL_INFO {
+ DWORD Version;
+ DWORD Provider;
+} WOF_EXTERNAL_INFO, *PWOF_EXTERNAL_INFO;
+#endif /* WOF_CURRENT_VERSION */
+
+#ifndef WIM_PROVIDER_CURRENT_VERSION
+#define WIM_PROVIDER_HASH_SIZE 20
+
+typedef struct _WIM_PROVIDER_EXTERNAL_INFO {
+ DWORD Version;
+ DWORD Flags;
+ LARGE_INTEGER DataSourceId;
+ BYTE ResourceHash[WIM_PROVIDER_HASH_SIZE];
+} WIM_PROVIDER_EXTERNAL_INFO, *PWIM_PROVIDER_EXTERNAL_INFO;
+#endif /* WIM_PROVIDER_CURRENT_VERSION */
+
+#ifndef FILE_PROVIDER_CURRENT_VERSION
+typedef struct _FILE_PROVIDER_EXTERNAL_INFO_V1 {
+ ULONG Version;
+ ULONG Algorithm;
+ ULONG Flags;
+} FILE_PROVIDER_EXTERNAL_INFO_V1, *PFILE_PROVIDER_EXTERNAL_INFO_V1;
+#endif /* FILE_PROVIDER_CURRENT_VERSION */
+
+#ifndef STATUS_OBJECT_NOT_EXTERNALLY_BACKED
+#define STATUS_OBJECT_NOT_EXTERNALLY_BACKED ((NTSTATUS)0xC000046DL)
+#endif
+#ifndef STATUS_INVALID_DEVICE_REQUEST
+#define STATUS_INVALID_DEVICE_REQUEST ((NTSTATUS)0xC0000010L)
+#endif
+
+#ifndef FILE_DEVICE_FILE_SYSTEM
+#define FILE_DEVICE_FILE_SYSTEM 0x00000009
+#endif
+
+#ifndef FSCTL_GET_EXTERNAL_BACKING
+#define FSCTL_GET_EXTERNAL_BACKING \
+ CTL_CODE(FILE_DEVICE_FILE_SYSTEM, 196, METHOD_BUFFERED, FILE_ANY_ACCESS)
+#endif
+
+#endif /* _WIN32 || _WIN64 */
+
+/*----------------------------------------------------------------------------*/
+
+#if _POSIX_C_SOURCE > 200212 && \
+ /* workaround for avoid musl libc wrong prototype */ ( \
+ defined(__GLIBC__) || defined(__GNU_LIBRARY__))
+/* Prototype should match libc runtime. ISO POSIX (2003) & LSB 1.x-3.x */
+__extern_C void __assert_fail(const char *assertion, const char *file,
+ unsigned line, const char *function)
+#ifdef __THROW
+ __THROW
+#else
+ __nothrow
+#endif /* __THROW */
+ __noreturn;
+
+#elif defined(__APPLE__) || defined(__MACH__)
+__extern_C void __assert_rtn(const char *function, const char *file, int line,
+ const char *assertion) /* __nothrow */
+#ifdef __dead2
+ __dead2
+#else
+ __noreturn
+#endif /* __dead2 */
+#ifdef __disable_tail_calls
+ __disable_tail_calls
+#endif /* __disable_tail_calls */
+ ;
+
+#define __assert_fail(assertion, file, line, function) \
+ __assert_rtn(function, file, line, assertion)
+#elif defined(__FreeBSD__) || defined(__NetBSD__) || defined(__OpenBSD__) || \
+ defined(__BSD__) || defined(__NETBSD__) || defined(__bsdi__) || \
+ defined(__DragonFly__)
+__extern_C void __assert(const char *function, const char *file, int line,
+ const char *assertion) /* __nothrow */
+#ifdef __dead2
+ __dead2
+#else
+ __noreturn
+#endif /* __dead2 */
+#ifdef __disable_tail_calls
+ __disable_tail_calls
+#endif /* __disable_tail_calls */
+ ;
+#define __assert_fail(assertion, file, line, function) \
+ __assert(function, file, line, assertion)
+
+#endif /* __assert_fail */
+
+MDBX_INTERNAL_FUNC void __cold mdbx_assert_fail(const MDBX_env *env,
+ const char *msg,
+ const char *func, int line) {
+#if MDBX_DEBUG
+ if (env && env->me_assert_func) {
+ env->me_assert_func(env, msg, func, line);
+ return;
+ }
+#else
+ (void)env;
+#endif /* MDBX_DEBUG */
+
+ if (mdbx_debug_logger)
+ mdbx_debug_log(MDBX_LOG_FATAL, func, line, "assert: %s\n", msg);
+ else {
+#if defined(_WIN32) || defined(_WIN64)
+ char *message = nullptr;
+ const int num = mdbx_asprintf(&message, "\r\nMDBX-ASSERTION: %s, %s:%u",
+ msg, func ? func : "unknown", line);
+ if (num < 1 || !message)
+ message = "";
+ OutputDebugStringA(message);
+ if (IsDebuggerPresent())
+ DebugBreak();
+#else
+ __assert_fail(msg, "mdbx", line, func);
+#endif
+ }
+
+#if defined(_WIN32) || defined(_WIN64)
+ FatalExit(ERROR_UNHANDLED_ERROR);
+#else
+ abort();
+#endif
+}
+
+MDBX_INTERNAL_FUNC __cold void mdbx_panic(const char *fmt, ...) {
+ va_list ap;
+ va_start(ap, fmt);
+
+ char *message = nullptr;
+ const int num = mdbx_vasprintf(&message, fmt, ap);
+ va_end(ap);
+ const char *const const_message =
+ (num < 1 || !message) ? ""
+ : message;
+
+#if defined(_WIN32) || defined(_WIN64)
+ OutputDebugStringA("\r\nMDBX-PANIC: ");
+ OutputDebugStringA(const_message);
+ if (IsDebuggerPresent())
+ DebugBreak();
+ FatalExit(ERROR_UNHANDLED_ERROR);
+#else
+ __assert_fail(const_message, "mdbx", 0, "panic");
+ abort();
+#endif
+}
+
+/*----------------------------------------------------------------------------*/
+
+#ifndef mdbx_vasprintf
+MDBX_INTERNAL_FUNC int mdbx_vasprintf(char **strp, const char *fmt,
+ va_list ap) {
+ va_list ones;
+ va_copy(ones, ap);
+ int needed = vsnprintf(nullptr, 0, fmt, ap);
+
+ if (unlikely(needed < 0 || needed >= INT_MAX)) {
+ *strp = nullptr;
+ va_end(ones);
+ return needed;
+ }
+
+ *strp = mdbx_malloc(needed + 1);
+ if (unlikely(*strp == nullptr)) {
+ va_end(ones);
+#if defined(_WIN32) || defined(_WIN64)
+ SetLastError(MDBX_ENOMEM);
+#else
+ errno = MDBX_ENOMEM;
+#endif
+ return -1;
+ }
+
+ int actual = vsnprintf(*strp, needed + 1, fmt, ones);
+ va_end(ones);
+
+ assert(actual == needed);
+ if (unlikely(actual < 0)) {
+ mdbx_free(*strp);
+ *strp = nullptr;
+ }
+ return actual;
+}
+#endif /* mdbx_vasprintf */
+
+#ifndef mdbx_asprintf
+MDBX_INTERNAL_FUNC int mdbx_asprintf(char **strp, const char *fmt, ...) {
+ va_list ap;
+ va_start(ap, fmt);
+ int rc = mdbx_vasprintf(strp, fmt, ap);
+ va_end(ap);
+ return rc;
+}
+#endif /* mdbx_asprintf */
+
+#ifndef mdbx_memalign_alloc
+MDBX_INTERNAL_FUNC int mdbx_memalign_alloc(size_t alignment, size_t bytes,
+ void **result) {
+#if defined(_WIN32) || defined(_WIN64)
+ (void)alignment;
+ *result = VirtualAlloc(NULL, bytes, MEM_COMMIT | MEM_RESERVE, PAGE_READWRITE);
+ return *result ? MDBX_SUCCESS : MDBX_ENOMEM /* ERROR_OUTOFMEMORY */;
+#elif defined(_ISOC11_SOURCE)
+ *result = aligned_alloc(alignment, bytes);
+ return *result ? MDBX_SUCCESS : errno;
+#elif _POSIX_VERSION >= 200112L
+ *result = nullptr;
+ return posix_memalign(result, alignment, bytes);
+#elif __GLIBC_PREREQ(2, 16) || __STDC_VERSION__ >= 201112L
+ *result = memalign(alignment, bytes);
+ return *result ? MDBX_SUCCESS : errno;
+#else
+#error FIXME
+#endif
+}
+#endif /* mdbx_memalign_alloc */
+
+#ifndef mdbx_memalign_free
+MDBX_INTERNAL_FUNC void mdbx_memalign_free(void *ptr) {
+#if defined(_WIN32) || defined(_WIN64)
+ VirtualFree(ptr, 0, MEM_RELEASE);
+#else
+ mdbx_free(ptr);
+#endif
+}
+#endif /* mdbx_memalign_free */
+
+#ifndef mdbx_strdup
+char *mdbx_strdup(const char *str) {
+ if (!str)
+ return NULL;
+ size_t bytes = strlen(str) + 1;
+ char *dup = mdbx_malloc(bytes);
+ if (dup)
+ memcpy(dup, str, bytes);
+ return dup;
+}
+#endif /* mdbx_strdup */
+
+/*----------------------------------------------------------------------------*/
+
+MDBX_INTERNAL_FUNC int mdbx_condmutex_init(mdbx_condmutex_t *condmutex) {
+#if defined(_WIN32) || defined(_WIN64)
+ int rc = MDBX_SUCCESS;
+ condmutex->event = NULL;
+ condmutex->mutex = CreateMutex(NULL, FALSE, NULL);
+ if (!condmutex->mutex)
+ return GetLastError();
+
+ condmutex->event = CreateEvent(NULL, FALSE, FALSE, NULL);
+ if (!condmutex->event) {
+ rc = GetLastError();
+ (void)CloseHandle(condmutex->mutex);
+ condmutex->mutex = NULL;
+ }
+ return rc;
+#else
+ memset(condmutex, 0, sizeof(mdbx_condmutex_t));
+ int rc = pthread_mutex_init(&condmutex->mutex, NULL);
+ if (rc == 0) {
+ rc = pthread_cond_init(&condmutex->cond, NULL);
+ if (rc != 0)
+ (void)pthread_mutex_destroy(&condmutex->mutex);
+ }
+ return rc;
+#endif
+}
+
+static bool is_allzeros(const void *ptr, size_t bytes) {
+ const uint8_t *u8 = ptr;
+ for (size_t i = 0; i < bytes; ++i)
+ if (u8[i] != 0)
+ return false;
+ return true;
+}
+
+MDBX_INTERNAL_FUNC int mdbx_condmutex_destroy(mdbx_condmutex_t *condmutex) {
+ int rc = MDBX_EINVAL;
+#if defined(_WIN32) || defined(_WIN64)
+ if (condmutex->event) {
+ rc = CloseHandle(condmutex->event) ? MDBX_SUCCESS : GetLastError();
+ if (rc == MDBX_SUCCESS)
+ condmutex->event = NULL;
+ }
+ if (condmutex->mutex) {
+ rc = CloseHandle(condmutex->mutex) ? MDBX_SUCCESS : GetLastError();
+ if (rc == MDBX_SUCCESS)
+ condmutex->mutex = NULL;
+ }
+#else
+ if (!is_allzeros(&condmutex->cond, sizeof(condmutex->cond))) {
+ rc = pthread_cond_destroy(&condmutex->cond);
+ if (rc == 0)
+ memset(&condmutex->cond, 0, sizeof(condmutex->cond));
+ }
+ if (!is_allzeros(&condmutex->mutex, sizeof(condmutex->mutex))) {
+ rc = pthread_mutex_destroy(&condmutex->mutex);
+ if (rc == 0)
+ memset(&condmutex->mutex, 0, sizeof(condmutex->mutex));
+ }
+#endif
+ return rc;
+}
+
+MDBX_INTERNAL_FUNC int mdbx_condmutex_lock(mdbx_condmutex_t *condmutex) {
+#if defined(_WIN32) || defined(_WIN64)
+ DWORD code = WaitForSingleObject(condmutex->mutex, INFINITE);
+ return waitstatus2errcode(code);
+#else
+ return pthread_mutex_lock(&condmutex->mutex);
+#endif
+}
+
+MDBX_INTERNAL_FUNC int mdbx_condmutex_unlock(mdbx_condmutex_t *condmutex) {
+#if defined(_WIN32) || defined(_WIN64)
+ return ReleaseMutex(condmutex->mutex) ? MDBX_SUCCESS : GetLastError();
+#else
+ return pthread_mutex_unlock(&condmutex->mutex);
+#endif
+}
+
+MDBX_INTERNAL_FUNC int mdbx_condmutex_signal(mdbx_condmutex_t *condmutex) {
+#if defined(_WIN32) || defined(_WIN64)
+ return SetEvent(condmutex->event) ? MDBX_SUCCESS : GetLastError();
+#else
+ return pthread_cond_signal(&condmutex->cond);
+#endif
+}
+
+MDBX_INTERNAL_FUNC int mdbx_condmutex_wait(mdbx_condmutex_t *condmutex) {
+#if defined(_WIN32) || defined(_WIN64)
+ DWORD code =
+ SignalObjectAndWait(condmutex->mutex, condmutex->event, INFINITE, FALSE);
+ if (code == WAIT_OBJECT_0)
+ code = WaitForSingleObject(condmutex->mutex, INFINITE);
+ return waitstatus2errcode(code);
+#else
+ return pthread_cond_wait(&condmutex->cond, &condmutex->mutex);
+#endif
+}
+
+/*----------------------------------------------------------------------------*/
+
+MDBX_INTERNAL_FUNC int mdbx_fastmutex_init(mdbx_fastmutex_t *fastmutex) {
+#if defined(_WIN32) || defined(_WIN64)
+ InitializeCriticalSection(fastmutex);
+ return MDBX_SUCCESS;
+#else
+ return pthread_mutex_init(fastmutex, NULL);
+#endif
+}
+
+MDBX_INTERNAL_FUNC int mdbx_fastmutex_destroy(mdbx_fastmutex_t *fastmutex) {
+#if defined(_WIN32) || defined(_WIN64)
+ DeleteCriticalSection(fastmutex);
+ return MDBX_SUCCESS;
+#else
+ return pthread_mutex_destroy(fastmutex);
+#endif
+}
+
+MDBX_INTERNAL_FUNC int mdbx_fastmutex_acquire(mdbx_fastmutex_t *fastmutex) {
+#if defined(_WIN32) || defined(_WIN64)
+ EnterCriticalSection(fastmutex);
+ return MDBX_SUCCESS;
+#else
+ return pthread_mutex_lock(fastmutex);
+#endif
+}
+
+MDBX_INTERNAL_FUNC int mdbx_fastmutex_release(mdbx_fastmutex_t *fastmutex) {
+#if defined(_WIN32) || defined(_WIN64)
+ LeaveCriticalSection(fastmutex);
+ return MDBX_SUCCESS;
+#else
+ return pthread_mutex_unlock(fastmutex);
+#endif
+}
+
+/*----------------------------------------------------------------------------*/
+
+MDBX_INTERNAL_FUNC int mdbx_removefile(const char *pathname) {
+#if defined(_WIN32) || defined(_WIN64)
+ return DeleteFileA(pathname) ? MDBX_SUCCESS : GetLastError();
+#else
+ return unlink(pathname) ? errno : MDBX_SUCCESS;
+#endif
+}
+
+MDBX_INTERNAL_FUNC int mdbx_openfile(const char *pathname, int flags,
+ mode_t mode, mdbx_filehandle_t *fd,
+ bool exclusive) {
+ *fd = INVALID_HANDLE_VALUE;
+#if defined(_WIN32) || defined(_WIN64)
+ (void)mode;
+ size_t wlen = mbstowcs(nullptr, pathname, INT_MAX);
+ if (wlen < 1 || wlen > /* MAX_PATH */ INT16_MAX)
+ return ERROR_INVALID_NAME;
+ wchar_t *const pathnameW = _alloca((wlen + 1) * sizeof(wchar_t));
+ if (wlen != mbstowcs(pathnameW, pathname, wlen + 1))
+ return ERROR_INVALID_NAME;
+
+ DWORD DesiredAccess, ShareMode;
+ DWORD FlagsAndAttributes = FILE_ATTRIBUTE_NORMAL;
+ switch (flags & (O_RDONLY | O_WRONLY | O_RDWR)) {
+ default:
+ return ERROR_INVALID_PARAMETER;
+ case O_RDONLY:
+ DesiredAccess = GENERIC_READ;
+ ShareMode =
+ exclusive ? FILE_SHARE_READ : (FILE_SHARE_READ | FILE_SHARE_WRITE);
+ break;
+ case O_WRONLY: /* assume for MDBX_env_copy() and friends output */
+ DesiredAccess = GENERIC_WRITE;
+ ShareMode = 0;
+ FlagsAndAttributes |= FILE_FLAG_NO_BUFFERING | FILE_FLAG_WRITE_THROUGH;
+ break;
+ case O_RDWR:
+ DesiredAccess = GENERIC_READ | GENERIC_WRITE;
+ ShareMode = exclusive ? 0 : (FILE_SHARE_READ | FILE_SHARE_WRITE);
+ break;
+ }
+
+ DWORD CreationDisposition;
+ switch (flags & (O_EXCL | O_CREAT)) {
+ default:
+ return ERROR_INVALID_PARAMETER;
+ case 0:
+ CreationDisposition = OPEN_EXISTING;
+ break;
+ case O_EXCL | O_CREAT:
+ CreationDisposition = CREATE_NEW;
+ FlagsAndAttributes |= FILE_ATTRIBUTE_NOT_CONTENT_INDEXED;
+ break;
+ case O_CREAT:
+ CreationDisposition = OPEN_ALWAYS;
+ FlagsAndAttributes |= FILE_ATTRIBUTE_NOT_CONTENT_INDEXED;
+ break;
+ }
+
+ *fd = CreateFileW(pathnameW, DesiredAccess, ShareMode, NULL,
+ CreationDisposition, FlagsAndAttributes, NULL);
+
+ if (*fd == INVALID_HANDLE_VALUE)
+ return GetLastError();
+ if ((flags & O_CREAT) && GetLastError() != ERROR_ALREADY_EXISTS) {
+ /* set FILE_ATTRIBUTE_NOT_CONTENT_INDEXED for new file */
+ DWORD FileAttributes = GetFileAttributesA(pathname);
+ if (FileAttributes == INVALID_FILE_ATTRIBUTES ||
+ !SetFileAttributesA(pathname, FileAttributes |
+ FILE_ATTRIBUTE_NOT_CONTENT_INDEXED)) {
+ int rc = GetLastError();
+ CloseHandle(*fd);
+ *fd = INVALID_HANDLE_VALUE;
+ return rc;
+ }
+ }
+#else
+ (void)exclusive;
+#ifdef O_CLOEXEC
+ flags |= O_CLOEXEC;
+#endif /* O_CLOEXEC */
+ *fd = open(pathname, flags, mode);
+ if (*fd < 0)
+ return errno;
+
+#if defined(FD_CLOEXEC) && !defined(O_CLOEXEC)
+ int fd_flags = fcntl(*fd, F_GETFD);
+ if (fd_flags != -1)
+ (void)fcntl(*fd, F_SETFD, fd_flags | FD_CLOEXEC);
+#endif /* FD_CLOEXEC && !O_CLOEXEC */
+
+ if ((flags & (O_RDONLY | O_WRONLY | O_RDWR)) == O_WRONLY) {
+ /* assume for MDBX_env_copy() and friends output */
+#if defined(O_DIRECT)
+ int fd_flags = fcntl(*fd, F_GETFD);
+ if (fd_flags != -1)
+ (void)fcntl(*fd, F_SETFL, fd_flags | O_DIRECT);
+#endif /* O_DIRECT */
+#if defined(F_NOCACHE)
+ (void)fcntl(*fd, F_NOCACHE, 1);
+#endif /* F_NOCACHE */
+ }
+#endif
+
+ return MDBX_SUCCESS;
+}
+
+MDBX_INTERNAL_FUNC int mdbx_closefile(mdbx_filehandle_t fd) {
+#if defined(_WIN32) || defined(_WIN64)
+ return CloseHandle(fd) ? MDBX_SUCCESS : GetLastError();
+#else
+ return (close(fd) == 0) ? MDBX_SUCCESS : errno;
+#endif
+}
+
+MDBX_INTERNAL_FUNC int mdbx_pread(mdbx_filehandle_t fd, void *buf, size_t bytes,
+ uint64_t offset) {
+ if (bytes > MAX_WRITE)
+ return MDBX_EINVAL;
+#if defined(_WIN32) || defined(_WIN64)
+ OVERLAPPED ov;
+ ov.hEvent = 0;
+ ov.Offset = (DWORD)offset;
+ ov.OffsetHigh = HIGH_DWORD(offset);
+
+ DWORD read = 0;
+ if (unlikely(!ReadFile(fd, buf, (DWORD)bytes, &read, &ov))) {
+ int rc = GetLastError();
+ return (rc == MDBX_SUCCESS) ? /* paranoia */ ERROR_READ_FAULT : rc;
+ }
+#else
+ STATIC_ASSERT_MSG(sizeof(off_t) >= sizeof(size_t),
+ "libmdbx requires 64-bit file I/O on 64-bit systems");
+ intptr_t read = pread(fd, buf, bytes, offset);
+ if (read < 0) {
+ int rc = errno;
+ return (rc == MDBX_SUCCESS) ? /* paranoia */ MDBX_EIO : rc;
+ }
+#endif
+ return (bytes == (size_t)read) ? MDBX_SUCCESS : MDBX_ENODATA;
+}
+
+MDBX_INTERNAL_FUNC int mdbx_pwrite(mdbx_filehandle_t fd, const void *buf,
+ size_t bytes, uint64_t offset) {
+ while (true) {
+#if defined(_WIN32) || defined(_WIN64)
+ OVERLAPPED ov;
+ ov.hEvent = 0;
+ ov.Offset = (DWORD)offset;
+ ov.OffsetHigh = HIGH_DWORD(offset);
+
+ DWORD written;
+ if (unlikely(!WriteFile(
+ fd, buf, likely(bytes <= MAX_WRITE) ? (DWORD)bytes : MAX_WRITE,
+ &written, &ov)))
+ return GetLastError();
+ if (likely(bytes == written))
+ return MDBX_SUCCESS;
+#else
+ STATIC_ASSERT_MSG(sizeof(off_t) >= sizeof(size_t),
+ "libmdbx requires 64-bit file I/O on 64-bit systems");
+ const intptr_t written =
+ pwrite(fd, buf, likely(bytes <= MAX_WRITE) ? bytes : MAX_WRITE, offset);
+ if (likely(bytes == (size_t)written))
+ return MDBX_SUCCESS;
+ if (written < 0) {
+ const int rc = errno;
+ if (rc != EINTR)
+ return rc;
+ continue;
+ }
+#endif
+ bytes -= written;
+ offset += written;
+ buf = (char *)buf + written;
+ }
+}
+
+MDBX_INTERNAL_FUNC int mdbx_write(mdbx_filehandle_t fd, const void *buf,
+ size_t bytes) {
+ while (true) {
+#if defined(_WIN32) || defined(_WIN64)
+ DWORD written;
+ if (unlikely(!WriteFile(
+ fd, buf, likely(bytes <= MAX_WRITE) ? (DWORD)bytes : MAX_WRITE,
+ &written, nullptr)))
+ return GetLastError();
+ if (likely(bytes == written))
+ return MDBX_SUCCESS;
+#else
+ STATIC_ASSERT_MSG(sizeof(off_t) >= sizeof(size_t),
+ "libmdbx requires 64-bit file I/O on 64-bit systems");
+ const intptr_t written =
+ write(fd, buf, likely(bytes <= MAX_WRITE) ? bytes : MAX_WRITE);
+ if (likely(bytes == (size_t)written))
+ return MDBX_SUCCESS;
+ if (written < 0) {
+ const int rc = errno;
+ if (rc != EINTR)
+ return rc;
+ continue;
+ }
+#endif
+ bytes -= written;
+ buf = (char *)buf + written;
+ }
+}
+
+int mdbx_pwritev(mdbx_filehandle_t fd, struct iovec *iov, int iovcnt,
+ uint64_t offset, size_t expected_written) {
+#if defined(_WIN32) || defined(_WIN64) || defined(__APPLE__)
+ size_t written = 0;
+ for (int i = 0; i < iovcnt; ++i) {
+ int rc = mdbx_pwrite(fd, iov[i].iov_base, iov[i].iov_len, offset);
+ if (unlikely(rc != MDBX_SUCCESS))
+ return rc;
+ written += iov[i].iov_len;
+ offset += iov[i].iov_len;
+ }
+ return (expected_written == written) ? MDBX_SUCCESS
+ : MDBX_EIO /* ERROR_WRITE_FAULT */;
+#else
+ int rc;
+ intptr_t written;
+ do {
+ STATIC_ASSERT_MSG(sizeof(off_t) >= sizeof(size_t),
+ "libmdbx requires 64-bit file I/O on 64-bit systems");
+ written = pwritev(fd, iov, iovcnt, offset);
+ if (likely(expected_written == (size_t)written))
+ return MDBX_SUCCESS;
+ rc = errno;
+ } while (rc == EINTR);
+ return (written < 0) ? rc : MDBX_EIO /* Use which error code? */;
+#endif
+}
+
+MDBX_INTERNAL_FUNC int mdbx_filesync(mdbx_filehandle_t fd,
+ enum mdbx_syncmode_bits mode_bits) {
+#if defined(_WIN32) || defined(_WIN64)
+ return ((mode_bits & (MDBX_SYNC_DATA | MDBX_SYNC_IODQ)) == 0 ||
+ FlushFileBuffers(fd))
+ ? MDBX_SUCCESS
+ : GetLastError();
+#else
+
+#if defined(__APPLE__) && \
+ MDBX_OSX_SPEED_INSTEADOF_DURABILITY == MDBX_OSX_WANNA_DURABILITY
+ if (mode_bits & MDBX_SYNC_IODQ)
+ return likely(fcntl(fd, F_FULLFSYNC) != -1) ? MDBX_SUCCESS : errno;
+#endif /* MacOS */
+#if defined(__linux__) || defined(__gnu_linux__)
+ if (mode_bits == MDBX_SYNC_SIZE && mdbx_linux_kernel_version >= 0x03060000)
+ return MDBX_SUCCESS;
+#endif /* Linux */
+ int rc;
+ do {
+#if defined(_POSIX_SYNCHRONIZED_IO) && _POSIX_SYNCHRONIZED_IO > 0
+ /* LY: This code is always safe and without appreciable performance
+ * degradation, even on a kernel with fdatasync's bug.
+ *
+ * For more info about of a corresponding fdatasync() bug
+ * see http://www.spinics.net/lists/linux-ext4/msg33714.html */
+ if ((mode_bits & MDBX_SYNC_SIZE) == 0) {
+ if (fdatasync(fd) == 0)
+ return MDBX_SUCCESS;
+ } else
+#else
+ (void)mode_bits;
+#endif
+ if (fsync(fd) == 0)
+ return MDBX_SUCCESS;
+ rc = errno;
+ } while (rc == EINTR);
+ return rc;
+#endif
+}
+
+int mdbx_filesize(mdbx_filehandle_t fd, uint64_t *length) {
+#if defined(_WIN32) || defined(_WIN64)
+ BY_HANDLE_FILE_INFORMATION info;
+ if (!GetFileInformationByHandle(fd, &info))
+ return GetLastError();
+ *length = info.nFileSizeLow | (uint64_t)info.nFileSizeHigh << 32;
+#else
+ struct stat st;
+
+ STATIC_ASSERT_MSG(sizeof(off_t) <= sizeof(uint64_t),
+ "libmdbx requires 64-bit file I/O on 64-bit systems");
+ if (fstat(fd, &st))
+ return errno;
+
+ *length = st.st_size;
+#endif
+ return MDBX_SUCCESS;
+}
+
+MDBX_INTERNAL_FUNC int mdbx_is_pipe(mdbx_filehandle_t fd) {
+#if defined(_WIN32) || defined(_WIN64)
+ switch (GetFileType(fd)) {
+ case FILE_TYPE_DISK:
+ return MDBX_RESULT_FALSE;
+ case FILE_TYPE_CHAR:
+ case FILE_TYPE_PIPE:
+ return MDBX_RESULT_TRUE;
+ default:
+ return GetLastError();
+ }
+#else
+ struct stat info;
+ if (fstat(fd, &info))
+ return errno;
+ switch (info.st_mode & S_IFMT) {
+ case S_IFBLK:
+ case S_IFREG:
+ return MDBX_RESULT_FALSE;
+ case S_IFCHR:
+ case S_IFIFO:
+ case S_IFSOCK:
+ return MDBX_RESULT_TRUE;
+ case S_IFDIR:
+ case S_IFLNK:
+ default:
+ return MDBX_INCOMPATIBLE;
+ }
+#endif
+}
+
+MDBX_INTERNAL_FUNC int mdbx_ftruncate(mdbx_filehandle_t fd, uint64_t length) {
+#if defined(_WIN32) || defined(_WIN64)
+ if (mdbx_SetFileInformationByHandle) {
+ FILE_END_OF_FILE_INFO EndOfFileInfo;
+ EndOfFileInfo.EndOfFile.QuadPart = length;
+ return mdbx_SetFileInformationByHandle(fd, FileEndOfFileInfo,
+ &EndOfFileInfo,
+ sizeof(FILE_END_OF_FILE_INFO))
+ ? MDBX_SUCCESS
+ : GetLastError();
+ } else {
+ LARGE_INTEGER li;
+ li.QuadPart = length;
+ return (SetFilePointerEx(fd, li, NULL, FILE_BEGIN) && SetEndOfFile(fd))
+ ? MDBX_SUCCESS
+ : GetLastError();
+ }
+#else
+ STATIC_ASSERT_MSG(sizeof(off_t) >= sizeof(size_t),
+ "libmdbx requires 64-bit file I/O on 64-bit systems");
+ return ftruncate(fd, length) == 0 ? MDBX_SUCCESS : errno;
+#endif
+}
+
+MDBX_INTERNAL_FUNC int mdbx_fseek(mdbx_filehandle_t fd, uint64_t pos) {
+#if defined(_WIN32) || defined(_WIN64)
+ LARGE_INTEGER li;
+ li.QuadPart = pos;
+ return SetFilePointerEx(fd, li, NULL, FILE_BEGIN) ? MDBX_SUCCESS
+ : GetLastError();
+#else
+ STATIC_ASSERT_MSG(sizeof(off_t) >= sizeof(size_t),
+ "libmdbx requires 64-bit file I/O on 64-bit systems");
+ return (lseek(fd, pos, SEEK_SET) < 0) ? errno : MDBX_SUCCESS;
+#endif
+}
+
+/*----------------------------------------------------------------------------*/
+
+MDBX_INTERNAL_FUNC int
+mdbx_thread_create(mdbx_thread_t *thread,
+ THREAD_RESULT(THREAD_CALL *start_routine)(void *),
+ void *arg) {
+#if defined(_WIN32) || defined(_WIN64)
+ *thread = CreateThread(NULL, 0, start_routine, arg, 0, NULL);
+ return *thread ? MDBX_SUCCESS : GetLastError();
+#else
+ return pthread_create(thread, NULL, start_routine, arg);
+#endif
+}
+
+MDBX_INTERNAL_FUNC int mdbx_thread_join(mdbx_thread_t thread) {
+#if defined(_WIN32) || defined(_WIN64)
+ DWORD code = WaitForSingleObject(thread, INFINITE);
+ return waitstatus2errcode(code);
+#else
+ void *unused_retval = &unused_retval;
+ return pthread_join(thread, &unused_retval);
+#endif
+}
+
+/*----------------------------------------------------------------------------*/
+
+MDBX_INTERNAL_FUNC int mdbx_msync(mdbx_mmap_t *map, size_t offset,
+ size_t length, int async) {
+ uint8_t *ptr = (uint8_t *)map->address + offset;
+#if defined(_WIN32) || defined(_WIN64)
+ if (FlushViewOfFile(ptr, length) && (async || FlushFileBuffers(map->fd)))
+ return MDBX_SUCCESS;
+ return GetLastError();
+#else
+#if defined(__linux__) || defined(__gnu_linux__)
+ if (async && mdbx_linux_kernel_version > 0x02061300)
+ /* Since Linux 2.6.19, MS_ASYNC is in fact a no-op,
+ since the kernel properly tracks dirty pages and flushes them to storage
+ as necessary. */
+ return MDBX_SUCCESS;
+#endif /* Linux */
+ const int mode = async ? MS_ASYNC : MS_SYNC;
+ int rc = (msync(ptr, length, mode) == 0) ? MDBX_SUCCESS : errno;
+#if defined(__APPLE__) && \
+ MDBX_OSX_SPEED_INSTEADOF_DURABILITY == MDBX_OSX_WANNA_DURABILITY
+ if (rc == MDBX_SUCCESS && mode == MS_SYNC)
+ rc = likely(fcntl(map->fd, F_FULLFSYNC) != -1) ? MDBX_SUCCESS : errno;
+#endif /* MacOS */
+ return rc;
+#endif
+}
+
+MDBX_INTERNAL_FUNC int mdbx_check4nonlocal(mdbx_filehandle_t handle,
+ int flags) {
+#if defined(_WIN32) || defined(_WIN64)
+ if (GetFileType(handle) != FILE_TYPE_DISK)
+ return ERROR_FILE_OFFLINE;
+
+ if (mdbx_GetFileInformationByHandleEx) {
+ FILE_REMOTE_PROTOCOL_INFO RemoteProtocolInfo;
+ if (mdbx_GetFileInformationByHandleEx(handle, FileRemoteProtocolInfo,
+ &RemoteProtocolInfo,
+ sizeof(RemoteProtocolInfo))) {
+
+ if ((RemoteProtocolInfo.Flags & REMOTE_PROTOCOL_INFO_FLAG_OFFLINE) &&
+ !(flags & MDBX_RDONLY))
+ return ERROR_FILE_OFFLINE;
+ if (!(RemoteProtocolInfo.Flags & REMOTE_PROTOCOL_INFO_FLAG_LOOPBACK) &&
+ !(flags & MDBX_EXCLUSIVE))
+ return ERROR_REMOTE_STORAGE_MEDIA_ERROR;
+ }
+ }
+
+ if (mdbx_NtFsControlFile) {
+ NTSTATUS rc;
+ struct {
+ WOF_EXTERNAL_INFO wof_info;
+ union {
+ WIM_PROVIDER_EXTERNAL_INFO wim_info;
+ FILE_PROVIDER_EXTERNAL_INFO_V1 file_info;
+ };
+ size_t reserved_for_microsoft_madness[42];
+ } GetExternalBacking_OutputBuffer;
+ IO_STATUS_BLOCK StatusBlock;
+ rc = mdbx_NtFsControlFile(handle, NULL, NULL, NULL, &StatusBlock,
+ FSCTL_GET_EXTERNAL_BACKING, NULL, 0,
+ &GetExternalBacking_OutputBuffer,
+ sizeof(GetExternalBacking_OutputBuffer));
+ if (NT_SUCCESS(rc)) {
+ if (!(flags & MDBX_EXCLUSIVE))
+ return ERROR_REMOTE_STORAGE_MEDIA_ERROR;
+ } else if (rc != STATUS_OBJECT_NOT_EXTERNALLY_BACKED &&
+ rc != STATUS_INVALID_DEVICE_REQUEST)
+ return ntstatus2errcode(rc);
+ }
+
+ if (mdbx_GetVolumeInformationByHandleW && mdbx_GetFinalPathNameByHandleW) {
+ WCHAR *PathBuffer = mdbx_malloc(sizeof(WCHAR) * INT16_MAX);
+ if (!PathBuffer)
+ return MDBX_ENOMEM;
+
+ int rc = MDBX_SUCCESS;
+ DWORD VolumeSerialNumber, FileSystemFlags;
+ if (!mdbx_GetVolumeInformationByHandleW(handle, PathBuffer, INT16_MAX,
+ &VolumeSerialNumber, NULL,
+ &FileSystemFlags, NULL, 0)) {
+ rc = GetLastError();
+ goto bailout;
+ }
+
+ if ((flags & MDBX_RDONLY) == 0) {
+ if (FileSystemFlags &
+ (FILE_SEQUENTIAL_WRITE_ONCE | FILE_READ_ONLY_VOLUME |
+ FILE_VOLUME_IS_COMPRESSED)) {
+ rc = ERROR_REMOTE_STORAGE_MEDIA_ERROR;
+ goto bailout;
+ }
+ }
+
+ if (!mdbx_GetFinalPathNameByHandleW(handle, PathBuffer, INT16_MAX,
+ FILE_NAME_NORMALIZED |
+ VOLUME_NAME_NT)) {
+ rc = GetLastError();
+ goto bailout;
+ }
+
+ if (_wcsnicmp(PathBuffer, L"\\Device\\Mup\\", 12) == 0) {
+ if (!(flags & MDBX_EXCLUSIVE)) {
+ rc = ERROR_REMOTE_STORAGE_MEDIA_ERROR;
+ goto bailout;
+ }
+ } else if (mdbx_GetFinalPathNameByHandleW(handle, PathBuffer, INT16_MAX,
+ FILE_NAME_NORMALIZED |
+ VOLUME_NAME_DOS)) {
+ UINT DriveType = GetDriveTypeW(PathBuffer);
+ if (DriveType == DRIVE_NO_ROOT_DIR &&
+ _wcsnicmp(PathBuffer, L"\\\\?\\", 4) == 0 &&
+ _wcsnicmp(PathBuffer + 5, L":\\", 2) == 0) {
+ PathBuffer[7] = 0;
+ DriveType = GetDriveTypeW(PathBuffer + 4);
+ }
+ switch (DriveType) {
+ case DRIVE_CDROM:
+ if (flags & MDBX_RDONLY)
+ break;
+ // fall through
+ case DRIVE_UNKNOWN:
+ case DRIVE_NO_ROOT_DIR:
+ case DRIVE_REMOTE:
+ default:
+ if (!(flags & MDBX_EXCLUSIVE))
+ rc = ERROR_REMOTE_STORAGE_MEDIA_ERROR;
+ // fall through
+ case DRIVE_REMOVABLE:
+ case DRIVE_FIXED:
+ case DRIVE_RAMDISK:
+ break;
+ }
+ }
+ bailout:
+ mdbx_free(PathBuffer);
+ return rc;
+ }
+#else
+ (void)handle;
+ /* TODO: check for NFS handle ? */
+ (void)flags;
+#endif
+ return MDBX_SUCCESS;
+}
+
+MDBX_INTERNAL_FUNC int mdbx_mmap(const int flags, mdbx_mmap_t *map,
+ const size_t size, const size_t limit,
+ const bool truncate) {
+ assert(size <= limit);
+ map->limit = 0;
+ map->current = 0;
+ map->address = nullptr;
+#if defined(_WIN32) || defined(_WIN64)
+ map->section = NULL;
+ map->filesize = 0;
+#endif /* Windows */
+
+ int err = mdbx_check4nonlocal(map->fd, flags);
+ if (unlikely(err != MDBX_SUCCESS))
+ return err;
+
+ if ((flags & MDBX_RDONLY) == 0 && truncate) {
+ err = mdbx_ftruncate(map->fd, size);
+ if (err != MDBX_SUCCESS)
+ return err;
+#if defined(_WIN32) || defined(_WIN64)
+ map->filesize = size;
+#else
+ map->current = size;
+#endif
+ } else {
+ uint64_t filesize;
+ err = mdbx_filesize(map->fd, &filesize);
+ if (err != MDBX_SUCCESS)
+ return err;
+#if defined(_WIN32) || defined(_WIN64)
+ map->filesize = filesize;
+#else
+ map->current = (filesize > limit) ? limit : (size_t)filesize;
+#endif
+ }
+
+#if defined(_WIN32) || defined(_WIN64)
+ LARGE_INTEGER SectionSize;
+ SectionSize.QuadPart = size;
+ err = NtCreateSection(
+ &map->section,
+ /* DesiredAccess */
+ (flags & MDBX_WRITEMAP)
+ ? SECTION_QUERY | SECTION_MAP_READ | SECTION_EXTEND_SIZE |
+ SECTION_MAP_WRITE
+ : SECTION_QUERY | SECTION_MAP_READ | SECTION_EXTEND_SIZE,
+ /* ObjectAttributes */ NULL, /* MaximumSize (InitialSize) */ &SectionSize,
+ /* SectionPageProtection */
+ (flags & MDBX_RDONLY) ? PAGE_READONLY : PAGE_READWRITE,
+ /* AllocationAttributes */ SEC_RESERVE, map->fd);
+ if (!NT_SUCCESS(err))
+ return ntstatus2errcode(err);
+
+ SIZE_T ViewSize = (flags & MDBX_RDONLY) ? 0 : limit;
+ err = NtMapViewOfSection(
+ map->section, GetCurrentProcess(), &map->address,
+ /* ZeroBits */ 0,
+ /* CommitSize */ 0,
+ /* SectionOffset */ NULL, &ViewSize,
+ /* InheritDisposition */ ViewUnmap,
+ /* AllocationType */ (flags & MDBX_RDONLY) ? 0 : MEM_RESERVE,
+ /* Win32Protect */
+ (flags & MDBX_WRITEMAP) ? PAGE_READWRITE : PAGE_READONLY);
+ if (!NT_SUCCESS(err)) {
+ NtClose(map->section);
+ map->section = 0;
+ map->address = nullptr;
+ return ntstatus2errcode(err);
+ }
+ assert(map->address != MAP_FAILED);
+
+ map->current = (size_t)SectionSize.QuadPart;
+ map->limit = ViewSize;
+
+#else
+
+ map->address = mmap(
+ NULL, limit, (flags & MDBX_WRITEMAP) ? PROT_READ | PROT_WRITE : PROT_READ,
+ MAP_SHARED, map->fd, 0);
+
+ if (unlikely(map->address == MAP_FAILED)) {
+ map->limit = 0;
+ map->current = 0;
+ map->address = nullptr;
+ return errno;
+ }
+ map->limit = limit;
+
+#ifdef MADV_DONTFORK
+ if (unlikely(madvise(map->address, map->limit, MADV_DONTFORK) != 0))
+ return errno;
+#endif
+#ifdef MADV_NOHUGEPAGE
+ (void)madvise(map->address, map->limit, MADV_NOHUGEPAGE);
+#endif
+
+#endif
+
+ return MDBX_SUCCESS;
+}
+
+MDBX_INTERNAL_FUNC int mdbx_munmap(mdbx_mmap_t *map) {
+#if defined(_WIN32) || defined(_WIN64)
+ if (map->section)
+ NtClose(map->section);
+ NTSTATUS rc = NtUnmapViewOfSection(GetCurrentProcess(), map->address);
+ if (!NT_SUCCESS(rc))
+ ntstatus2errcode(rc);
+#else
+ if (unlikely(munmap(map->address, map->limit)))
+ return errno;
+#endif
+
+ map->limit = 0;
+ map->current = 0;
+ map->address = nullptr;
+ return MDBX_SUCCESS;
+}
+
+MDBX_INTERNAL_FUNC int mdbx_mresize(int flags, mdbx_mmap_t *map, size_t size,
+ size_t limit) {
+ assert(size <= limit);
+#if defined(_WIN32) || defined(_WIN64)
+ assert(size != map->current || limit != map->limit || size < map->filesize);
+
+ NTSTATUS status;
+ LARGE_INTEGER SectionSize;
+ int err, rc = MDBX_SUCCESS;
+
+ if (!(flags & MDBX_RDONLY) && limit == map->limit && size > map->current) {
+ /* growth rw-section */
+ SectionSize.QuadPart = size;
+ status = NtExtendSection(map->section, &SectionSize);
+ if (NT_SUCCESS(status)) {
+ map->current = size;
+ if (map->filesize < size)
+ map->filesize = size;
+ }
+ return ntstatus2errcode(status);
+ }
+
+ if (limit > map->limit) {
+ /* check ability of address space for growth before umnap */
+ PVOID BaseAddress = (PBYTE)map->address + map->limit;
+ SIZE_T RegionSize = limit - map->limit;
+ status = NtAllocateVirtualMemory(GetCurrentProcess(), &BaseAddress, 0,
+ &RegionSize, MEM_RESERVE, PAGE_NOACCESS);
+ if (!NT_SUCCESS(status))
+ return ntstatus2errcode(status);
+
+ status = NtFreeVirtualMemory(GetCurrentProcess(), &BaseAddress, &RegionSize,
+ MEM_RELEASE);
+ if (!NT_SUCCESS(status))
+ return ntstatus2errcode(status);
+ }
+
+ /* Windows unable:
+ * - shrink a mapped file;
+ * - change size of mapped view;
+ * - extend read-only mapping;
+ * Therefore we should unmap/map entire section. */
+ status = NtUnmapViewOfSection(GetCurrentProcess(), map->address);
+ if (!NT_SUCCESS(status))
+ return ntstatus2errcode(status);
+ status = NtClose(map->section);
+ map->section = NULL;
+ PVOID ReservedAddress = NULL;
+ SIZE_T ReservedSize = limit;
+
+ if (!NT_SUCCESS(status)) {
+ bailout_ntstatus:
+ err = ntstatus2errcode(status);
+ bailout:
+ map->address = NULL;
+ map->current = map->limit = 0;
+ if (ReservedAddress)
+ (void)NtFreeVirtualMemory(GetCurrentProcess(), &ReservedAddress,
+ &ReservedSize, MEM_RELEASE);
+ return err;
+ }
+
+ /* resizing of the file may take a while,
+ * therefore we reserve address space to avoid occupy it by other threads */
+ ReservedAddress = map->address;
+ status = NtAllocateVirtualMemory(GetCurrentProcess(), &ReservedAddress, 0,
+ &ReservedSize, MEM_RESERVE, PAGE_NOACCESS);
+ if (!NT_SUCCESS(status)) {
+ ReservedAddress = NULL;
+ if (status != /* STATUS_CONFLICTING_ADDRESSES */ 0xC0000018)
+ goto bailout_ntstatus /* no way to recovery */;
+
+ /* assume we can change base address if mapping size changed or prev address
+ * couldn't be used */
+ map->address = NULL;
+ }
+
+retry_file_and_section:
+ err = mdbx_filesize(map->fd, &map->filesize);
+ if (err != MDBX_SUCCESS)
+ goto bailout;
+
+ if ((flags & MDBX_RDONLY) == 0 && map->filesize != size) {
+ err = mdbx_ftruncate(map->fd, size);
+ if (err == MDBX_SUCCESS)
+ map->filesize = size;
+ /* ignore error, because Windows unable shrink file
+ * that already mapped (by another process) */
+ }
+
+ SectionSize.QuadPart = size;
+ status = NtCreateSection(
+ &map->section,
+ /* DesiredAccess */
+ (flags & MDBX_WRITEMAP)
+ ? SECTION_QUERY | SECTION_MAP_READ | SECTION_EXTEND_SIZE |
+ SECTION_MAP_WRITE
+ : SECTION_QUERY | SECTION_MAP_READ | SECTION_EXTEND_SIZE,
+ /* ObjectAttributes */ NULL,
+ /* MaximumSize (InitialSize) */ &SectionSize,
+ /* SectionPageProtection */
+ (flags & MDBX_RDONLY) ? PAGE_READONLY : PAGE_READWRITE,
+ /* AllocationAttributes */ SEC_RESERVE, map->fd);
+
+ if (!NT_SUCCESS(status))
+ goto bailout_ntstatus;
+
+ if (ReservedAddress) {
+ /* release reserved address space */
+ status = NtFreeVirtualMemory(GetCurrentProcess(), &ReservedAddress,
+ &ReservedSize, MEM_RELEASE);
+ ReservedAddress = NULL;
+ if (!NT_SUCCESS(status))
+ goto bailout_ntstatus;
+ }
+
+retry_mapview:;
+ SIZE_T ViewSize = (flags & MDBX_RDONLY) ? size : limit;
+ status = NtMapViewOfSection(
+ map->section, GetCurrentProcess(), &map->address,
+ /* ZeroBits */ 0,
+ /* CommitSize */ 0,
+ /* SectionOffset */ NULL, &ViewSize,
+ /* InheritDisposition */ ViewUnmap,
+ /* AllocationType */ (flags & MDBX_RDONLY) ? 0 : MEM_RESERVE,
+ /* Win32Protect */
+ (flags & MDBX_WRITEMAP) ? PAGE_READWRITE : PAGE_READONLY);
+
+ if (!NT_SUCCESS(status)) {
+ if (status == /* STATUS_CONFLICTING_ADDRESSES */ 0xC0000018 &&
+ map->address) {
+ /* try remap at another base address */
+ map->address = NULL;
+ goto retry_mapview;
+ }
+ NtClose(map->section);
+ map->section = NULL;
+
+ if (map->address && (size != map->current || limit != map->limit)) {
+ /* try remap with previously size and limit,
+ * but will return MDBX_RESULT_TRUE on success */
+ rc = MDBX_RESULT_TRUE;
+ size = map->current;
+ limit = map->limit;
+ goto retry_file_and_section;
+ }
+
+ /* no way to recovery */
+ goto bailout_ntstatus;
+ }
+ assert(map->address != MAP_FAILED);
+
+ map->current = (size_t)SectionSize.QuadPart;
+ map->limit = ViewSize;
+#else
+
+ uint64_t filesize;
+ int rc = mdbx_filesize(map->fd, &filesize);
+ if (rc != MDBX_SUCCESS)
+ return rc;
+
+ if (flags & MDBX_RDONLY) {
+ map->current = (filesize > limit) ? limit : (size_t)filesize;
+ if (map->current != size)
+ rc = MDBX_RESULT_TRUE;
+ } else if (filesize != size) {
+ rc = mdbx_ftruncate(map->fd, size);
+ if (rc != MDBX_SUCCESS)
+ return rc;
+ map->current = size;
+ }
+
+ if (limit != map->limit) {
+#if defined(_GNU_SOURCE) && (defined(__linux__) || defined(__gnu_linux__))
+ void *ptr = mremap(map->address, map->limit, limit,
+ /* LY: in case changing the mapping size calling code
+ must guarantees the absence of competing threads,
+ and a willingness to another base address */
+ MREMAP_MAYMOVE);
+ if (ptr == MAP_FAILED) {
+ rc = errno;
+ return (rc == EAGAIN || rc == ENOMEM) ? MDBX_RESULT_TRUE : rc;
+ }
+ map->address = ptr;
+ map->limit = limit;
+
+#ifdef MADV_DONTFORK
+ if (unlikely(madvise(map->address, map->limit, MADV_DONTFORK) != 0))
+ return errno;
+#endif
+
+#ifdef MADV_NOHUGEPAGE
+ (void)madvise(map->address, map->limit, MADV_NOHUGEPAGE);
+#endif
+
+#else
+ rc = MDBX_RESULT_TRUE;
+#endif /* _GNU_SOURCE && __linux__ */
+ }
+#endif
+ return rc;
+}
+
+/*----------------------------------------------------------------------------*/
+
+MDBX_INTERNAL_FUNC __cold void mdbx_osal_jitter(bool tiny) {
+ for (;;) {
+#if defined(_M_IX86) || defined(_M_X64) || defined(__i386__) || \
+ defined(__x86_64__)
+ const unsigned salt = 277u * (unsigned)__rdtsc();
+#else
+ const unsigned salt = rand();
+#endif
+
+ const unsigned coin = salt % (tiny ? 29u : 43u);
+ if (coin < 43 / 3)
+ break;
+#if defined(_WIN32) || defined(_WIN64)
+ SwitchToThread();
+ if (coin > 43 * 2 / 3)
+ Sleep(1);
+#else
+ sched_yield();
+ if (coin > 43 * 2 / 3)
+ usleep(coin);
+#endif
+ }
+}
+
+#if defined(_WIN32) || defined(_WIN64)
+#elif defined(__APPLE__) || defined(__MACH__)
+#include
+#elif defined(__linux__) || defined(__gnu_linux__)
+static __cold clockid_t choice_monoclock(void) {
+ struct timespec probe;
+#if defined(CLOCK_BOOTTIME)
+ if (clock_gettime(CLOCK_BOOTTIME, &probe) == 0)
+ return CLOCK_BOOTTIME;
+#elif defined(CLOCK_MONOTONIC_RAW)
+ if (clock_gettime(CLOCK_MONOTONIC_RAW, &probe) == 0)
+ return CLOCK_MONOTONIC_RAW;
+#elif defined(CLOCK_MONOTONIC_COARSE)
+ if (clock_gettime(CLOCK_MONOTONIC_COARSE, &probe) == 0)
+ return CLOCK_MONOTONIC_COARSE;
+#endif
+ return CLOCK_MONOTONIC;
+}
+#endif
+
+/*----------------------------------------------------------------------------*/
+
+#if defined(_WIN32) || defined(_WIN64)
+static LARGE_INTEGER performance_frequency;
+#elif defined(__APPLE__) || defined(__MACH__)
+static uint64_t ratio_16dot16_to_monotine;
+#endif
+
+MDBX_INTERNAL_FUNC uint64_t
+mdbx_osal_16dot16_to_monotime(uint32_t seconds_16dot16) {
+#if defined(_WIN32) || defined(_WIN64)
+ if (unlikely(performance_frequency.QuadPart == 0))
+ QueryPerformanceFrequency(&performance_frequency);
+ const uint64_t ratio = performance_frequency.QuadPart;
+#elif defined(__APPLE__) || defined(__MACH__)
+ if (unlikely(ratio_16dot16_to_monotine == 0)) {
+ mach_timebase_info_data_t ti;
+ mach_timebase_info(&ti);
+ ratio_16dot16_to_monotine = UINT64_C(1000000000) * ti.denom / ti.numer;
+ }
+ const uint64_t ratio = ratio_16dot16_to_monotine;
+#else
+ const uint64_t ratio = UINT64_C(1000000000);
+#endif
+ return (ratio * seconds_16dot16 + 32768) >> 16;
+}
+
+MDBX_INTERNAL_FUNC uint32_t mdbx_osal_monotime_to_16dot16(uint64_t monotime) {
+ static uint64_t limit;
+ if (unlikely(monotime > limit)) {
+ if (limit != 0)
+ return UINT32_MAX;
+ limit = mdbx_osal_16dot16_to_monotime(UINT32_MAX - 1);
+ if (monotime > limit)
+ return UINT32_MAX;
+ }
+#if defined(_WIN32) || defined(_WIN64)
+ return (uint32_t)((monotime << 16) / performance_frequency.QuadPart);
+#elif defined(__APPLE__) || defined(__MACH__)
+ return (uint32_t)((monotime << 16) / ratio_16dot16_to_monotine);
+#else
+ return (uint32_t)(monotime * 128 / 1953125);
+#endif
+}
+
+MDBX_INTERNAL_FUNC uint64_t mdbx_osal_monotime(void) {
+#if defined(_WIN32) || defined(_WIN64)
+ LARGE_INTEGER counter;
+ counter.QuadPart = 0;
+ QueryPerformanceCounter(&counter);
+ return counter.QuadPart;
+#elif defined(__APPLE__) || defined(__MACH__)
+ return mach_absolute_time();
+#else
+
+#if defined(__linux__) || defined(__gnu_linux__)
+ static clockid_t posix_clockid = -1;
+ if (unlikely(posix_clockid < 0))
+ posix_clockid = choice_monoclock();
+#elif defined(CLOCK_MONOTONIC)
+#define posix_clockid CLOCK_MONOTONIC
+#else
+#define posix_clockid CLOCK_REALTIME
+#endif
+
+ struct timespec ts;
+ if (unlikely(clock_gettime(posix_clockid, &ts) != 0)) {
+ ts.tv_nsec = 0;
+ ts.tv_sec = 0;
+ }
+ return ts.tv_sec * UINT64_C(1000000000) + ts.tv_nsec;
+#endif
+}
+
+/*----------------------------------------------------------------------------*/
+
+static void bootid_shake(bin128_t *p) {
+ /* Bob Jenkins's PRNG: https://burtleburtle.net/bob/rand/smallprng.html */
+ const uint32_t e = p->a - (p->b << 23 | p->b >> 9);
+ p->a = p->b ^ (p->c << 16 | p->c >> 16);
+ p->b = p->c + (p->d << 11 | p->d >> 21);
+ p->c = p->d + e;
+ p->d = e + p->a;
+}
+
+static void bootid_collect(bin128_t *p, const void *s, size_t n) {
+ p->y += UINT64_C(64526882297375213);
+ bootid_shake(p);
+ for (size_t i = 0; i < n; ++i) {
+ bootid_shake(p);
+ p->y ^= UINT64_C(48797879452804441) * ((const uint8_t *)s)[i];
+ bootid_shake(p);
+ p->y += 14621231;
+ }
+ bootid_shake(p);
+
+ /* minor non-linear tomfoolery */
+ const unsigned z = p->x % 61;
+ p->y = p->y << z | p->y >> (64 - z);
+ bootid_shake(p);
+ bootid_shake(p);
+ const unsigned q = p->x % 59;
+ p->y = p->y << q | p->y >> (64 - q);
+ bootid_shake(p);
+ bootid_shake(p);
+ bootid_shake(p);
+}
+
+#if defined(_WIN32) || defined(_WIN64)
+
+static uint64_t windows_systemtime_ms() {
+ FILETIME ft;
+ GetSystemTimeAsFileTime(&ft);
+ return ((uint64_t)ft.dwHighDateTime << 32 | ft.dwLowDateTime) / 10000ul;
+}
+
+static uint64_t windows_bootime(void) {
+ unsigned confirmed = 0;
+ uint64_t boottime = 0;
+ uint64_t up0 = mdbx_GetTickCount64();
+ uint64_t st0 = windows_systemtime_ms();
+ for (uint64_t fuse = st0; up0 && st0 < fuse + 1000 * 1000u / 42;) {
+ YieldProcessor();
+ const uint64_t up1 = mdbx_GetTickCount64();
+ const uint64_t st1 = windows_systemtime_ms();
+ if (st1 > fuse && st1 == st0 && up1 == up0) {
+ uint64_t diff = st1 - up1;
+ if (boottime == diff) {
+ if (++confirmed > 4)
+ return boottime;
+ } else {
+ confirmed = 0;
+ boottime = diff;
+ }
+ fuse = st1;
+ Sleep(1);
+ }
+ st0 = st1;
+ up0 = up1;
+ }
+ return 0;
+}
+
+static LSTATUS mdbx_RegGetValue(HKEY hkey, LPCWSTR lpSubKey, LPCWSTR lpValue,
+ DWORD dwFlags, LPDWORD pdwType, PVOID pvData,
+ LPDWORD pcbData) {
+ LSTATUS rc =
+ RegGetValueW(hkey, lpSubKey, lpValue, dwFlags, pdwType, pvData, pcbData);
+ if (rc != ERROR_FILE_NOT_FOUND)
+ return rc;
+
+ rc = RegGetValueW(hkey, lpSubKey, lpValue,
+ dwFlags | 0x00010000 /* RRF_SUBKEY_WOW6464KEY */, pdwType,
+ pvData, pcbData);
+ if (rc != ERROR_FILE_NOT_FOUND)
+ return rc;
+ return RegGetValueW(hkey, lpSubKey, lpValue,
+ dwFlags | 0x00020000 /* RRF_SUBKEY_WOW6432KEY */, pdwType,
+ pvData, pcbData);
+}
+#endif
+
+static __cold __maybe_unused bool bootid_parse_uuid(bin128_t *s, const void *p,
+ const size_t n) {
+ if (n > 31) {
+ unsigned bits = 0;
+ for (unsigned i = 0; i < n; ++i) /* try parse an UUID in text form */ {
+ uint8_t c = ((const uint8_t *)p)[i];
+ if (c >= '0' && c <= '9')
+ c -= '0';
+ else if (c >= 'a' && c <= 'f')
+ c -= 'a' - 10;
+ else if (c >= 'A' && c <= 'F')
+ c -= 'A' - 10;
+ else
+ continue;
+ assert(c <= 15);
+ c ^= s->y >> 60;
+ s->y = s->y << 4 | s->x >> 60;
+ s->x = s->x << 4 | c;
+ bits += 4;
+ }
+ if (bits > 42 * 3)
+ /* UUID parsed successfully */
+ return true;
+ }
+
+ if (n > 15) /* is enough handle it as a binary? */ {
+ if (n == sizeof(bin128_t)) {
+ bin128_t aligned;
+ memcpy(&aligned, p, sizeof(bin128_t));
+ s->x += aligned.x;
+ s->y += aligned.y;
+ } else
+ bootid_collect(s, p, n);
+ return true;
+ }
+
+ if (n)
+ bootid_collect(s, p, n);
+ return false;
+}
+
+__cold MDBX_INTERNAL_FUNC bin128_t mdbx_osal_bootid(void) {
+ bin128_t bin = {{0, 0}};
+ bool got_machineid = false, got_bootime = false, got_bootseq = false;
+
+#if defined(__linux__) || defined(__gnu_linux__)
+ {
+ const int fd =
+ open("/proc/sys/kernel/random/boot_id", O_RDONLY | O_NOFOLLOW);
+ if (fd != -1) {
+ struct statvfs fs;
+ char buf[42];
+ const ssize_t len =
+ (fstatvfs(fd, &fs) == 0 && fs.f_fsid == /* procfs */ 0x00009FA0)
+ ? read(fd, buf, sizeof(buf))
+ : -1;
+ close(fd);
+ if (len > 0 && bootid_parse_uuid(&bin, buf, len))
+ return bin;
+ }
+ }
+#endif /* Linux */
+
+#if defined(__APPLE__) || defined(__MACH__)
+ {
+ char buf[42];
+ size_t len = sizeof(buf);
+ if (!sysctlbyname("kern.bootsessionuuid", buf, &len, nullptr, 0) &&
+ bootid_parse_uuid(&bin, buf, len))
+ return bin;
+
+#if defined(__MAC_OS_X_VERSION_MIN_REQUIRED) && \
+ __MAC_OS_X_VERSION_MIN_REQUIRED > 1050
+ uuid_t uuid;
+ struct timespec wait = {0, 1000000000u / 42};
+ if (!gethostuuid(uuid, &wait) &&
+ bootid_parse_uuid(&bin, uuid, sizeof(uuid)))
+ got_machineid = true;
+#endif /* > 10.5 */
+
+ struct timeval boottime;
+ len = sizeof(boottime);
+ if (!sysctlbyname("kern.boottime", &boottime, &len, nullptr, 0) &&
+ len == sizeof(boottime) && boottime.tv_sec)
+ got_bootime = true;
+ }
+#endif /* Apple/Darwin */
+
+#if defined(_WIN32) || defined(_WIN64)
+ {
+ union buf {
+ DWORD BootId;
+ DWORD BaseTime;
+ SYSTEM_TIMEOFDAY_INFORMATION SysTimeOfDayInfo;
+ struct {
+ LARGE_INTEGER BootTime;
+ LARGE_INTEGER CurrentTime;
+ LARGE_INTEGER TimeZoneBias;
+ ULONG TimeZoneId;
+ ULONG Reserved;
+ ULONGLONG BootTimeBias;
+ ULONGLONG SleepTimeBias;
+ } SysTimeOfDayInfoHacked;
+ wchar_t MachineGuid[42];
+ char DigitalProductId[248];
+ } buf;
+
+ static const wchar_t HKLM_MicrosoftCryptography[] =
+ L"SOFTWARE\\Microsoft\\Cryptography";
+ DWORD len = sizeof(buf);
+ /* Windows is madness and must die */
+ if (mdbx_RegGetValue(HKEY_LOCAL_MACHINE, HKLM_MicrosoftCryptography,
+ L"MachineGuid", RRF_RT_ANY, NULL, &buf.MachineGuid,
+ &len) == ERROR_SUCCESS &&
+ len > 42 && len < sizeof(buf))
+ got_machineid = bootid_parse_uuid(&bin, &buf.MachineGuid, len);
+
+ if (!got_machineid) {
+ /* again, Windows is madness */
+ static const wchar_t HKLM_WindowsNT[] =
+ L"SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion";
+ static const wchar_t HKLM_WindowsNT_DPK[] =
+ L"SOFTWARE\\Microsoft\\Windows "
+ L"NT\\CurrentVersion\\DefaultProductKey";
+ static const wchar_t HKLM_WindowsNT_DPK2[] =
+ L"SOFTWARE\\Microsoft\\Windows "
+ L"NT\\CurrentVersion\\DefaultProductKey2";
+
+ len = sizeof(buf);
+ if (mdbx_RegGetValue(HKEY_LOCAL_MACHINE, HKLM_WindowsNT,
+ L"DigitalProductId", RRF_RT_ANY, NULL,
+ &buf.DigitalProductId, &len) == ERROR_SUCCESS &&
+ len > 42 && len < sizeof(buf)) {
+ bootid_collect(&bin, &buf.DigitalProductId, len);
+ got_machineid = true;
+ }
+ len = sizeof(buf);
+ if (mdbx_RegGetValue(HKEY_LOCAL_MACHINE, HKLM_WindowsNT_DPK,
+ L"DigitalProductId", RRF_RT_ANY, NULL,
+ &buf.DigitalProductId, &len) == ERROR_SUCCESS &&
+ len > 42 && len < sizeof(buf)) {
+ bootid_collect(&bin, &buf.DigitalProductId, len);
+ got_machineid = true;
+ }
+ len = sizeof(buf);
+ if (mdbx_RegGetValue(HKEY_LOCAL_MACHINE, HKLM_WindowsNT_DPK2,
+ L"DigitalProductId", RRF_RT_ANY, NULL,
+ &buf.DigitalProductId, &len) == ERROR_SUCCESS &&
+ len > 42 && len < sizeof(buf)) {
+ bootid_collect(&bin, &buf.DigitalProductId, len);
+ got_machineid = true;
+ }
+ }
+
+ static const wchar_t HKLM_PrefetcherParams[] =
+ L"SYSTEM\\CurrentControlSet\\Control\\Session Manager\\Memory "
+ L"Management\\PrefetchParameters";
+ len = sizeof(buf);
+ if (mdbx_RegGetValue(HKEY_LOCAL_MACHINE, HKLM_PrefetcherParams, L"BootId",
+ RRF_RT_DWORD, NULL, &buf.BootId,
+ &len) == ERROR_SUCCESS &&
+ len > 1 && len < sizeof(buf)) {
+ bootid_collect(&bin, &buf.BootId, len);
+ got_bootseq = true;
+ }
+
+ len = sizeof(buf);
+ if (mdbx_RegGetValue(HKEY_LOCAL_MACHINE, HKLM_PrefetcherParams, L"BaseTime",
+ RRF_RT_DWORD, NULL, &buf.BaseTime,
+ &len) == ERROR_SUCCESS &&
+ len >= sizeof(buf.BaseTime) && buf.BaseTime) {
+ bootid_collect(&bin, &buf.BaseTime, len);
+ got_bootime = true;
+ }
+
+ /* BootTime from SYSTEM_TIMEOFDAY_INFORMATION */
+ NTSTATUS status = NtQuerySystemInformation(
+ 0x03 /* SystemTmeOfDayInformation */, &buf.SysTimeOfDayInfo,
+ sizeof(buf.SysTimeOfDayInfo), &len);
+ if (NT_SUCCESS(status) &&
+ len >= offsetof(union buf, SysTimeOfDayInfoHacked.BootTime) +
+ sizeof(buf.SysTimeOfDayInfoHacked.BootTime) &&
+ buf.SysTimeOfDayInfoHacked.BootTime.QuadPart) {
+ bootid_collect(&bin, &buf.SysTimeOfDayInfoHacked.BootTime,
+ sizeof(buf.SysTimeOfDayInfoHacked.BootTime));
+ got_bootime = true;
+ }
+
+ if (!got_bootime) {
+ uint64_t boottime = windows_bootime();
+ if (boottime) {
+ bootid_collect(&bin, &boottime, sizeof(boottime));
+ got_bootime = true;
+ }
+ }
+ }
+#endif /* Windows */
+
+#if defined(CTL_HW) && defined(HW_UUID)
+ if (!got_machineid) {
+ static const int mib[] = {CTL_HW, HW_UUID};
+ char buf[42];
+ size_t len = sizeof(buf);
+ if (sysctl(
+#ifdef SYSCTL_LEGACY_NONCONST_MIB
+ (int *)
+#endif
+ mib,
+ ARRAY_LENGTH(mib), &buf, &len, NULL, 0) == 0)
+ got_machineid = bootid_parse_uuid(&bin, buf, len);
+ }
+#endif /* CTL_HW && HW_UUID */
+
+#if defined(CTL_KERN) && defined(KERN_HOSTUUID)
+ if (!got_machineid) {
+ static const int mib[] = {CTL_KERN, KERN_HOSTUUID};
+ char buf[42];
+ size_t len = sizeof(buf);
+ if (sysctl(
+#ifdef SYSCTL_LEGACY_NONCONST_MIB
+ (int *)
+#endif
+ mib,
+ ARRAY_LENGTH(mib), &buf, &len, NULL, 0) == 0)
+ got_machineid = bootid_parse_uuid(&bin, buf, len);
+ }
+#endif /* CTL_KERN && KERN_HOSTUUID */
+
+#if defined(__NetBSD__)
+ if (!got_machineid) {
+ char buf[42];
+ size_t len = sizeof(buf);
+ if (sysctlbyname("machdep.dmi.system-uuid", buf, &len, NULL, 0) == 0)
+ got_machineid = bootid_parse_uuid(&bin, buf, len);
+ }
+#endif /* __NetBSD__ */
+
+#if _XOPEN_SOURCE_EXTENDED
+ if (!got_machineid) {
+ const int hostid = gethostid();
+ if (hostid > 0) {
+ bootid_collect(&bin, &hostid, sizeof(hostid));
+ got_machineid = true;
+ }
+ }
+#endif /* _XOPEN_SOURCE_EXTENDED */
+
+ if (!got_machineid) {
+ lack:
+ bin.x = bin.y = 0;
+ return bin;
+ }
+
+ /*--------------------------------------------------------------------------*/
+
+#if defined(CTL_KERN) && defined(KERN_BOOTTIME)
+ if (!got_bootime) {
+ static const int mib[] = {CTL_KERN, KERN_BOOTTIME};
+ struct timeval boottime;
+ size_t len = sizeof(boottime);
+ if (sysctl(
+#ifdef SYSCTL_LEGACY_NONCONST_MIB
+ (int *)
+#endif
+ mib,
+ ARRAY_LENGTH(mib), &boottime, &len, NULL, 0) == 0 &&
+ len == sizeof(boottime) && boottime.tv_sec) {
+ bootid_collect(&bin, &boottime, len);
+ got_bootime = true;
+ }
+ }
+#endif /* CTL_KERN && KERN_BOOTTIME */
+
+#if defined(__sun) || defined(__SVR4) || defined(__svr4__)
+ if (!got_bootime) {
+ kstat_ctl_t *kc = kstat_open();
+ if (kc) {
+ kstat_t *kp = kstat_lookup(kc, "unix", 0, "system_misc");
+ if (kp && kstat_read(kc, kp, 0) != -1) {
+ kstat_named_t *kn = (kstat_named_t *)kstat_data_lookup(kp, "boot_time");
+ if (kn) {
+ switch (kn->data_type) {
+ case KSTAT_DATA_INT32:
+ case KSTAT_DATA_UINT32:
+ bootid_collect(&bin, &kn->value, sizeof(int32_t));
+ got_boottime = true;
+ case KSTAT_DATA_INT64:
+ case KSTAT_DATA_UINT64:
+ bootid_collect(&bin, &kn->value, sizeof(int64_t));
+ got_boottime = true;
+ }
+ }
+ }
+ kstat_close(kc);
+ }
+ }
+#endif /* SunOS / Solaris */
+
+#if _XOPEN_SOURCE_EXTENDED && defined(BOOT_TIME)
+ if (!got_bootime) {
+ setutxent();
+ const struct utmpx id = {.ut_type = BOOT_TIME};
+ const struct utmpx *entry = getutxid(&id);
+ if (entry) {
+ bootid_collect(&bin, entry, sizeof(*entry));
+ got_bootime = true;
+ while (unlikely((entry = getutxid(&id)) != nullptr)) {
+ /* have multiple reboot records, assuming we can distinguish next
+ * bootsession even if RTC is wrong or absent */
+ bootid_collect(&bin, entry, sizeof(*entry));
+ got_bootseq = true;
+ }
+ }
+ endutxent();
+ }
+#endif /* _XOPEN_SOURCE_EXTENDED && BOOT_TIME */
+
+ if (!got_bootseq) {
+ if (!got_bootime || !MDBX_TRUST_RTC)
+ goto lack;
+
+#if defined(_WIN32) || defined(_WIN64)
+ FILETIME now;
+ GetSystemTimeAsFileTime(&now);
+ if (0x1CCCCCC > now.dwHighDateTime)
+#else
+ struct timespec mono, real;
+ if (clock_gettime(CLOCK_MONOTONIC, &mono) ||
+ clock_gettime(CLOCK_REALTIME, &real) ||
+ /* wrong time, RTC is mad or absent */
+ 1555555555l > real.tv_sec ||
+ /* seems no adjustment by RTC/NTP, i.e. a fake time */
+ real.tv_sec < mono.tv_sec || 1234567890l > real.tv_sec - mono.tv_sec ||
+ (real.tv_sec - mono.tv_sec) % 900u == 0)
+#endif
+ goto lack;
+ }
+
+ return bin;
+}
diff --git a/contrib/db/libmdbx/src/elements/osal.h b/contrib/db/libmdbx/src/elements/osal.h
new file mode 100644
index 00000000..c1988ad7
--- /dev/null
+++ b/contrib/db/libmdbx/src/elements/osal.h
@@ -0,0 +1,959 @@
+/* https://en.wikipedia.org/wiki/Operating_system_abstraction_layer */
+
+/*
+ * Copyright 2015-2019 Leonid Yuriev
+ * and other libmdbx authors: please see AUTHORS file.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted only as authorized by the OpenLDAP
+ * Public License.
+ *
+ * A copy of this license is available in the file LICENSE in the
+ * top-level directory of the distribution or, alternatively, at
+ * .
+ */
+
+#pragma once
+
+/*----------------------------------------------------------------------------*/
+/* Microsoft compiler generates a lot of warning for self includes... */
+
+#ifdef _MSC_VER
+#pragma warning(push, 1)
+#pragma warning(disable : 4548) /* expression before comma has no effect; \
+ expected expression with side - effect */
+#pragma warning(disable : 4530) /* C++ exception handler used, but unwind \
+ * semantics are not enabled. Specify /EHsc */
+#pragma warning(disable : 4577) /* 'noexcept' used with no exception handling \
+ * mode specified; termination on exception is \
+ * not guaranteed. Specify /EHsc */
+#endif /* _MSC_VER (warnings) */
+
+#if defined(_WIN32) || defined(_WIN64)
+#if !defined(_CRT_SECURE_NO_WARNINGS)
+#define _CRT_SECURE_NO_WARNINGS
+#endif
+#if !defined(_NO_CRT_STDIO_INLINE) && MDBX_BUILD_SHARED_LIBRARY && \
+ !defined(MDBX_TOOLS)
+#define _NO_CRT_STDIO_INLINE
+#endif
+#endif /* Windows */
+
+/*----------------------------------------------------------------------------*/
+/* C99 includes */
+#include
+#include
+#include
+#include
+
+#include
+#include
+#include
+#include
+#include
+#include
+
+/* C11 stdalign.h */
+#if __has_include()
+#include
+#elif defined(__STDC_VERSION__) && __STDC_VERSION__ >= 201112L
+#define alignas(N) _Alignas(N)
+#elif defined(_MSC_VER)
+#define alignas(N) __declspec(align(N))
+#elif __has_attribute(__aligned__) || defined(__GNUC__)
+#define alignas(N) __attribute__((__aligned__(N)))
+#else
+#error "FIXME: Required _alignas() or equivalent."
+#endif
+
+/*----------------------------------------------------------------------------*/
+/* Systems includes */
+
+#if defined(__FreeBSD__) || defined(__NetBSD__) || defined(__OpenBSD__) || \
+ defined(__BSD__) || defined(__NETBSD__) || defined(__bsdi__) || \
+ defined(__DragonFly__) || defined(__APPLE__) || defined(__MACH__)
+#include
+#include
+#include
+#if defined(__FreeBSD__) || defined(__DragonFly__)
+#include
+#elif defined(__OpenBSD__) || defined(__NetBSD__)
+#include
+#else
+#define SYSCTL_LEGACY_NONCONST_MIB
+#endif
+#include
+#else
+#include
+#ifndef _POSIX_C_SOURCE
+#ifdef _POSIX_SOURCE
+#define _POSIX_C_SOURCE 1
+#else
+#define _POSIX_C_SOURCE 0
+#endif
+#endif
+#endif /* !xBSD */
+
+#if defined(__FreeBSD__) || defined(__OpenBSD__) || __has_include()
+#include
+#endif
+
+#if defined(__APPLE__) || defined(__MACH__) || __has_include()
+#include
+#endif /* MacOS */
+
+#if defined(__MACH__)
+#include
+#include
+#include
+#include
+#undef P_DIRTY
+#endif
+
+#if defined(__linux__) || defined(__gnu_linux__)
+#include
+#include
+#include
+#endif /* Linux */
+
+#ifndef _XOPEN_SOURCE
+#define _XOPEN_SOURCE 0
+#endif
+
+#ifndef _XOPEN_SOURCE_EXTENDED
+#define _XOPEN_SOURCE_EXTENDED 0
+#else
+#include
+#endif /* _XOPEN_SOURCE_EXTENDED */
+
+#if defined(__sun) || defined(__SVR4) || defined(__svr4__)
+#include
+#endif /* SunOS/Solaris */
+
+#if defined(_WIN32) || defined(_WIN64)
+#ifndef WIN32_LEAN_AND_MEAN
+#define WIN32_LEAN_AND_MEAN
+#endif
+#include
+#include
+#include
+#include
+#define HAVE_SYS_STAT_H
+#define HAVE_SYS_TYPES_H
+typedef HANDLE mdbx_thread_t;
+typedef unsigned mdbx_thread_key_t;
+#define MDBX_OSAL_SECTION HANDLE
+#define MAP_FAILED NULL
+#define HIGH_DWORD(v) ((DWORD)((sizeof(v) > 4) ? ((uint64_t)(v) >> 32) : 0))
+#define THREAD_CALL WINAPI
+#define THREAD_RESULT DWORD
+typedef struct {
+ HANDLE mutex;
+ HANDLE event;
+} mdbx_condmutex_t;
+typedef CRITICAL_SECTION mdbx_fastmutex_t;
+
+#if MDBX_AVOID_CRT
+#ifndef mdbx_malloc
+static inline void *mdbx_malloc(size_t bytes) {
+ return LocalAlloc(LMEM_FIXED, bytes);
+}
+#endif /* mdbx_malloc */
+
+#ifndef mdbx_calloc
+static inline void *mdbx_calloc(size_t nelem, size_t size) {
+ return LocalAlloc(LMEM_FIXED | LMEM_ZEROINIT, nelem * size);
+}
+#endif /* mdbx_calloc */
+
+#ifndef mdbx_realloc
+static inline void *mdbx_realloc(void *ptr, size_t bytes) {
+ return LocalReAlloc(ptr, bytes, LMEM_MOVEABLE);
+}
+#endif /* mdbx_realloc */
+
+#ifndef mdbx_free
+#define mdbx_free LocalFree
+#endif /* mdbx_free */
+#else
+#define mdbx_malloc malloc
+#define mdbx_calloc calloc
+#define mdbx_realloc realloc
+#define mdbx_free free
+#define mdbx_strdup _strdup
+#endif /* MDBX_AVOID_CRT */
+
+#ifndef snprintf
+#define snprintf _snprintf /* ntdll */
+#endif
+
+#ifndef vsnprintf
+#define vsnprintf _vsnprintf /* ntdll */
+#endif
+
+#else /*----------------------------------------------------------------------*/
+
+#include
+#include
+#include
+#include
+#include
+#include
+#include
+#include
+typedef pthread_t mdbx_thread_t;
+typedef pthread_key_t mdbx_thread_key_t;
+#define INVALID_HANDLE_VALUE (-1)
+#define THREAD_CALL
+#define THREAD_RESULT void *
+typedef struct {
+ pthread_mutex_t mutex;
+ pthread_cond_t cond;
+} mdbx_condmutex_t;
+typedef pthread_mutex_t mdbx_fastmutex_t;
+#define mdbx_malloc malloc
+#define mdbx_calloc calloc
+#define mdbx_realloc realloc
+#define mdbx_free free
+#define mdbx_strdup strdup
+#endif /* Platform */
+
+#if __GLIBC_PREREQ(2, 12) || defined(__FreeBSD__) || defined(malloc_usable_size)
+/* malloc_usable_size() already provided */
+#elif defined(__APPLE__)
+#define malloc_usable_size(ptr) malloc_size(ptr)
+#elif defined(_MSC_VER) && !MDBX_AVOID_CRT
+#define malloc_usable_size(ptr) _msize(ptr)
+#endif /* malloc_usable_size */
+
+/* *INDENT-OFF* */
+/* clang-format off */
+#if defined(HAVE_SYS_STAT_H) || __has_include()
+#include
+#endif
+#if defined(HAVE_SYS_TYPES_H) || __has_include()
+#include
+#endif
+#if defined(HAVE_SYS_FILE_H) || __has_include()
+#include
+#endif
+/* *INDENT-ON* */
+/* clang-format on */
+
+#ifndef SSIZE_MAX
+#define SSIZE_MAX INTPTR_MAX
+#endif
+
+#if !defined(MADV_DODUMP) && defined(MADV_CORE)
+#define MADV_DODUMP MADV_CORE
+#endif /* MADV_CORE -> MADV_DODUMP */
+
+#if !defined(MADV_DONTDUMP) && defined(MADV_NOCORE)
+#define MADV_DONTDUMP MADV_NOCORE
+#endif /* MADV_NOCORE -> MADV_DONTDUMP */
+
+#if defined(i386) || defined(__386) || defined(__i386) || defined(__i386__) || \
+ defined(i486) || defined(__i486) || defined(__i486__) || \
+ defined(i586) | defined(__i586) || defined(__i586__) || defined(i686) || \
+ defined(__i686) || defined(__i686__) || defined(_M_IX86) || \
+ defined(_X86_) || defined(__THW_INTEL__) || defined(__I86__) || \
+ defined(__INTEL__) || defined(__x86_64) || defined(__x86_64__) || \
+ defined(__amd64__) || defined(__amd64) || defined(_M_X64) || \
+ defined(_M_AMD64) || defined(__IA32__) || defined(__INTEL__)
+#ifndef __ia32__
+/* LY: define neutral __ia32__ for x86 and x86-64 archs */
+#define __ia32__ 1
+#endif /* __ia32__ */
+#if !defined(__amd64__) && (defined(__x86_64) || defined(__x86_64__) || \
+ defined(__amd64) || defined(_M_X64))
+/* LY: define trusty __amd64__ for all AMD64/x86-64 arch */
+#define __amd64__ 1
+#endif /* __amd64__ */
+#endif /* all x86 */
+
+#if !defined(MDBX_UNALIGNED_OK)
+#if defined(_MSC_VER)
+#define MDBX_UNALIGNED_OK 1 /* avoid MSVC misoptimization */
+#elif __CLANG_PREREQ(5, 0) || __GNUC_PREREQ(5, 0)
+#define MDBX_UNALIGNED_OK 0 /* expecting optimization is well done */
+#elif (defined(__ia32__) || defined(__ARM_FEATURE_UNALIGNED)) && \
+ !defined(__ALIGNED__)
+#define MDBX_UNALIGNED_OK 1
+#else
+#define MDBX_UNALIGNED_OK 0
+#endif
+#endif /* MDBX_UNALIGNED_OK */
+
+#if (-6 & 5) || CHAR_BIT != 8 || UINT_MAX < 0xffffffff || ULONG_MAX % 0xFFFF
+#error \
+ "Sanity checking failed: Two's complement, reasonably sized integer types"
+#endif
+
+/*----------------------------------------------------------------------------*/
+/* Compiler's includes for builtins/intrinsics */
+
+#if defined(_MSC_VER) || defined(__INTEL_COMPILER)
+#include
+#elif __GNUC_PREREQ(4, 4) || defined(__clang__)
+#if defined(__ia32__) || defined(__e2k__)
+#include
+#endif /* __ia32__ */
+#if defined(__ia32__)
+#include
+#endif /* __ia32__ */
+#elif defined(__SUNPRO_C) || defined(__sun) || defined(sun)
+#include
+#elif (defined(_HPUX_SOURCE) || defined(__hpux) || defined(__HP_aCC)) && \
+ (defined(HP_IA64) || defined(__ia64))
+#include
+#elif defined(__IBMC__) && defined(__powerpc)
+#include
+#elif defined(_AIX)
+#include
+#include
+#elif (defined(__osf__) && defined(__DECC)) || defined(__alpha)
+#include
+#include
+#elif defined(__MWERKS__)
+/* CodeWarrior - troubles ? */
+#pragma gcc_extensions
+#elif defined(__SNC__)
+/* Sony PS3 - troubles ? */
+#elif defined(__hppa__) || defined(__hppa)
+#include
+#else
+#error Unsupported C compiler, please use GNU C 4.4 or newer
+#endif /* Compiler */
+
+/*----------------------------------------------------------------------------*/
+/* Byteorder */
+
+#if !defined(__BYTE_ORDER__) || !defined(__ORDER_LITTLE_ENDIAN__) || \
+ !defined(__ORDER_BIG_ENDIAN__)
+
+/* *INDENT-OFF* */
+/* clang-format off */
+#if defined(__GLIBC__) || defined(__GNU_LIBRARY__) || defined(__ANDROID__) || \
+ defined(HAVE_ENDIAN_H) || __has_include()
+#include
+#elif defined(__APPLE__) || defined(__MACH__) || defined(__OpenBSD__) || \
+ defined(HAVE_MACHINE_ENDIAN_H) || __has_include()
+#include
+#elif defined(HAVE_SYS_ISA_DEFS_H) || __has_include()
+#include
+#elif (defined(HAVE_SYS_TYPES_H) && defined(HAVE_SYS_ENDIAN_H)) || \
+ (__has_include() && __has_include())
+#include
+#include
+#elif defined(__bsdi__) || defined(__DragonFly__) || defined(__FreeBSD__) || \
+ defined(__NETBSD__) || defined(__NetBSD__) || \
+ defined(HAVE_SYS_PARAM_H) || __has_include()
+#include
+#endif /* OS */
+/* *INDENT-ON* */
+/* clang-format on */
+
+#if defined(__BYTE_ORDER) && defined(__LITTLE_ENDIAN) && defined(__BIG_ENDIAN)
+#define __ORDER_LITTLE_ENDIAN__ __LITTLE_ENDIAN
+#define __ORDER_BIG_ENDIAN__ __BIG_ENDIAN
+#define __BYTE_ORDER__ __BYTE_ORDER
+#elif defined(_BYTE_ORDER) && defined(_LITTLE_ENDIAN) && defined(_BIG_ENDIAN)
+#define __ORDER_LITTLE_ENDIAN__ _LITTLE_ENDIAN
+#define __ORDER_BIG_ENDIAN__ _BIG_ENDIAN
+#define __BYTE_ORDER__ _BYTE_ORDER
+#else
+#define __ORDER_LITTLE_ENDIAN__ 1234
+#define __ORDER_BIG_ENDIAN__ 4321
+
+#if defined(__LITTLE_ENDIAN__) || \
+ (defined(_LITTLE_ENDIAN) && !defined(_BIG_ENDIAN)) || \
+ defined(__ARMEL__) || defined(__THUMBEL__) || defined(__AARCH64EL__) || \
+ defined(__MIPSEL__) || defined(_MIPSEL) || defined(__MIPSEL) || \
+ defined(_M_ARM) || defined(_M_ARM64) || defined(__e2k__) || \
+ defined(__elbrus_4c__) || defined(__elbrus_8c__) || defined(__bfin__) || \
+ defined(__BFIN__) || defined(__ia64__) || defined(_IA64) || \
+ defined(__IA64__) || defined(__ia64) || defined(_M_IA64) || \
+ defined(__itanium__) || defined(__ia32__) || defined(__CYGWIN__) || \
+ defined(_WIN64) || defined(_WIN32) || defined(__TOS_WIN__) || \
+ defined(__WINDOWS__)
+#define __BYTE_ORDER__ __ORDER_LITTLE_ENDIAN__
+
+#elif defined(__BIG_ENDIAN__) || \
+ (defined(_BIG_ENDIAN) && !defined(_LITTLE_ENDIAN)) || \
+ defined(__ARMEB__) || defined(__THUMBEB__) || defined(__AARCH64EB__) || \
+ defined(__MIPSEB__) || defined(_MIPSEB) || defined(__MIPSEB) || \
+ defined(__m68k__) || defined(M68000) || defined(__hppa__) || \
+ defined(__hppa) || defined(__HPPA__) || defined(__sparc__) || \
+ defined(__sparc) || defined(__370__) || defined(__THW_370__) || \
+ defined(__s390__) || defined(__s390x__) || defined(__SYSC_ZARCH__)
+#define __BYTE_ORDER__ __ORDER_BIG_ENDIAN__
+
+#else
+#error __BYTE_ORDER__ should be defined.
+#endif /* Arch */
+
+#endif
+#endif /* __BYTE_ORDER__ || __ORDER_LITTLE_ENDIAN__ || __ORDER_BIG_ENDIAN__ */
+
+/*----------------------------------------------------------------------------*/
+/* Memory/Compiler barriers, cache coherence */
+
+static __maybe_unused __inline void mdbx_compiler_barrier(void) {
+#if defined(__clang__) || defined(__GNUC__)
+ __asm__ __volatile__("" ::: "memory");
+#elif defined(_MSC_VER)
+ _ReadWriteBarrier();
+#elif defined(__INTEL_COMPILER) /* LY: Intel Compiler may mimic GCC and MSC */
+ __memory_barrier();
+ if (type > MDBX_BARRIER_COMPILER)
+#if defined(__ia64__) || defined(__ia64) || defined(_M_IA64)
+ __mf();
+#elif defined(__i386__) || defined(__x86_64__)
+ _mm_mfence();
+#else
+#error "Unknown target for Intel Compiler, please report to us."
+#endif
+#elif defined(__SUNPRO_C) || defined(__sun) || defined(sun)
+ __compiler_barrier();
+#elif (defined(_HPUX_SOURCE) || defined(__hpux) || defined(__HP_aCC)) && \
+ (defined(HP_IA64) || defined(__ia64))
+ _Asm_sched_fence(/* LY: no-arg meaning 'all expect ALU', e.g. 0x3D3D */);
+#elif defined(_AIX) || defined(__ppc__) || defined(__powerpc__) || \
+ defined(__ppc64__) || defined(__powerpc64__)
+ __fence();
+#else
+#error "Could not guess the kind of compiler, please report to us."
+#endif
+}
+
+static __maybe_unused __inline void mdbx_memory_barrier(void) {
+#if __has_extension(c_atomic) || __has_extension(cxx_atomic)
+ __c11_atomic_thread_fence(__ATOMIC_SEQ_CST);
+#elif defined(__ATOMIC_SEQ_CST)
+ __atomic_thread_fence(__ATOMIC_SEQ_CST);
+#elif defined(__clang__) || defined(__GNUC__)
+ __sync_synchronize();
+#elif defined(_MSC_VER)
+ MemoryBarrier();
+#elif defined(__INTEL_COMPILER) /* LY: Intel Compiler may mimic GCC and MSC */
+#if defined(__ia64__) || defined(__ia64) || defined(_M_IA64)
+ __mf();
+#elif defined(__i386__) || defined(__x86_64__)
+ _mm_mfence();
+#else
+#error "Unknown target for Intel Compiler, please report to us."
+#endif
+#elif defined(__SUNPRO_C) || defined(__sun) || defined(sun)
+ __machine_rw_barrier();
+#elif (defined(_HPUX_SOURCE) || defined(__hpux) || defined(__HP_aCC)) && \
+ (defined(HP_IA64) || defined(__ia64))
+ _Asm_mf();
+#elif defined(_AIX) || defined(__ppc__) || defined(__powerpc__) || \
+ defined(__ppc64__) || defined(__powerpc64__)
+ __lwsync();
+#else
+#error "Could not guess the kind of compiler, please report to us."
+#endif
+}
+
+/*----------------------------------------------------------------------------*/
+/* Cache coherence and invalidation */
+
+#ifndef MDBX_CPU_WRITEBACK_IS_COHERENT
+#if defined(__ia32__) || defined(__e2k__) || defined(__hppa) || \
+ defined(__hppa__)
+#define MDBX_CPU_WRITEBACK_IS_COHERENT 1
+#else
+#define MDBX_CPU_WRITEBACK_IS_COHERENT 0
+#endif
+#endif /* MDBX_CPU_WRITEBACK_IS_COHERENT */
+
+#ifndef MDBX_CACHELINE_SIZE
+#if defined(SYSTEM_CACHE_ALIGNMENT_SIZE)
+#define MDBX_CACHELINE_SIZE SYSTEM_CACHE_ALIGNMENT_SIZE
+#elif defined(__ia64__) || defined(__ia64) || defined(_M_IA64)
+#define MDBX_CACHELINE_SIZE 128
+#else
+#define MDBX_CACHELINE_SIZE 64
+#endif
+#endif /* MDBX_CACHELINE_SIZE */
+
+#if MDBX_CPU_WRITEBACK_IS_COHERENT
+#define mdbx_flush_noncoherent_cpu_writeback() mdbx_compiler_barrier()
+#else
+#define mdbx_flush_noncoherent_cpu_writeback() mdbx_memory_barrier()
+#endif
+
+#if __has_include()
+#include
+#elif defined(__mips) || defined(__mips__) || defined(__mips64) || \
+ defined(__mips64__) || defined(_M_MRX000) || defined(_MIPS_) || \
+ defined(__MWERKS__) || defined(__sgi)
+/* MIPS should have explicit cache control */
+#include
+#endif
+
+#ifndef MDBX_CPU_CACHE_MMAP_NONCOHERENT
+#if defined(__mips) || defined(__mips__) || defined(__mips64) || \
+ defined(__mips64__) || defined(_M_MRX000) || defined(_MIPS_) || \
+ defined(__MWERKS__) || defined(__sgi)
+/* MIPS has cache coherency issues. */
+#define MDBX_CPU_CACHE_MMAP_NONCOHERENT 1
+#else
+/* LY: assume no relevant mmap/dcache issues. */
+#define MDBX_CPU_CACHE_MMAP_NONCOHERENT 0
+#endif
+#endif /* ndef MDBX_CPU_CACHE_MMAP_NONCOHERENT */
+
+static __maybe_unused __inline void
+mdbx_invalidate_mmap_noncoherent_cache(void *addr, size_t nbytes) {
+#if MDBX_CPU_CACHE_MMAP_NONCOHERENT
+#ifdef DCACHE
+ /* MIPS has cache coherency issues.
+ * Note: for any nbytes >= on-chip cache size, entire is flushed. */
+ cacheflush(addr, nbytes, DCACHE);
+#else
+#error "Oops, cacheflush() not available"
+#endif /* DCACHE */
+#else /* MDBX_CPU_CACHE_MMAP_NONCOHERENT */
+ (void)addr;
+ (void)nbytes;
+#endif /* MDBX_CPU_CACHE_MMAP_NONCOHERENT */
+}
+
+/*----------------------------------------------------------------------------*/
+/* libc compatibility stuff */
+
+#if (!defined(__GLIBC__) && __GLIBC_PREREQ(2, 1)) && \
+ (defined(_GNU_SOURCE) || defined(_BSD_SOURCE))
+#define mdbx_asprintf asprintf
+#define mdbx_vasprintf vasprintf
+#else
+MDBX_INTERNAL_FUNC __printf_args(2, 3) int __maybe_unused
+ mdbx_asprintf(char **strp, const char *fmt, ...);
+MDBX_INTERNAL_FUNC int mdbx_vasprintf(char **strp, const char *fmt, va_list ap);
+#endif
+
+/*----------------------------------------------------------------------------*/
+/* OS abstraction layer stuff */
+
+/* max bytes to write in one call */
+#if defined(_WIN32) || defined(_WIN64)
+#define MAX_WRITE UINT32_C(0x01000000)
+#else
+#define MAX_WRITE UINT32_C(0x3fff0000)
+#endif
+
+#if defined(__linux__) || defined(__gnu_linux__)
+MDBX_INTERNAL_VAR uint32_t mdbx_linux_kernel_version;
+#endif /* Linux */
+
+/* Get the size of a memory page for the system.
+ * This is the basic size that the platform's memory manager uses, and is
+ * fundamental to the use of memory-mapped files. */
+static __maybe_unused __inline size_t mdbx_syspagesize(void) {
+#if defined(_WIN32) || defined(_WIN64)
+ SYSTEM_INFO si;
+ GetSystemInfo(&si);
+ return si.dwPageSize;
+#else
+ return sysconf(_SC_PAGE_SIZE);
+#endif
+}
+
+#ifndef mdbx_strdup
+LIBMDBX_API char *mdbx_strdup(const char *str);
+#endif
+
+static __maybe_unused __inline int mdbx_get_errno(void) {
+#if defined(_WIN32) || defined(_WIN64)
+ DWORD rc = GetLastError();
+#else
+ int rc = errno;
+#endif
+ return rc;
+}
+
+#ifndef mdbx_memalign_alloc
+MDBX_INTERNAL_FUNC int mdbx_memalign_alloc(size_t alignment, size_t bytes,
+ void **result);
+#endif
+#ifndef mdbx_memalign_free
+MDBX_INTERNAL_FUNC void mdbx_memalign_free(void *ptr);
+#endif
+
+MDBX_INTERNAL_FUNC int mdbx_condmutex_init(mdbx_condmutex_t *condmutex);
+MDBX_INTERNAL_FUNC int mdbx_condmutex_lock(mdbx_condmutex_t *condmutex);
+MDBX_INTERNAL_FUNC int mdbx_condmutex_unlock(mdbx_condmutex_t *condmutex);
+MDBX_INTERNAL_FUNC int mdbx_condmutex_signal(mdbx_condmutex_t *condmutex);
+MDBX_INTERNAL_FUNC int mdbx_condmutex_wait(mdbx_condmutex_t *condmutex);
+MDBX_INTERNAL_FUNC int mdbx_condmutex_destroy(mdbx_condmutex_t *condmutex);
+
+MDBX_INTERNAL_FUNC int mdbx_fastmutex_init(mdbx_fastmutex_t *fastmutex);
+MDBX_INTERNAL_FUNC int mdbx_fastmutex_acquire(mdbx_fastmutex_t *fastmutex);
+MDBX_INTERNAL_FUNC int mdbx_fastmutex_release(mdbx_fastmutex_t *fastmutex);
+MDBX_INTERNAL_FUNC int mdbx_fastmutex_destroy(mdbx_fastmutex_t *fastmutex);
+
+MDBX_INTERNAL_FUNC int mdbx_pwritev(mdbx_filehandle_t fd, struct iovec *iov,
+ int iovcnt, uint64_t offset,
+ size_t expected_written);
+MDBX_INTERNAL_FUNC int mdbx_pread(mdbx_filehandle_t fd, void *buf, size_t count,
+ uint64_t offset);
+MDBX_INTERNAL_FUNC int mdbx_pwrite(mdbx_filehandle_t fd, const void *buf,
+ size_t count, uint64_t offset);
+MDBX_INTERNAL_FUNC int mdbx_write(mdbx_filehandle_t fd, const void *buf,
+ size_t count);
+
+MDBX_INTERNAL_FUNC int
+mdbx_thread_create(mdbx_thread_t *thread,
+ THREAD_RESULT(THREAD_CALL *start_routine)(void *),
+ void *arg);
+MDBX_INTERNAL_FUNC int mdbx_thread_join(mdbx_thread_t thread);
+
+enum mdbx_syncmode_bits {
+ MDBX_SYNC_DATA = 1,
+ MDBX_SYNC_SIZE = 2,
+ MDBX_SYNC_IODQ = 4
+};
+
+MDBX_INTERNAL_FUNC int mdbx_filesync(mdbx_filehandle_t fd,
+ enum mdbx_syncmode_bits mode_bits);
+MDBX_INTERNAL_FUNC int mdbx_ftruncate(mdbx_filehandle_t fd, uint64_t length);
+MDBX_INTERNAL_FUNC int mdbx_fseek(mdbx_filehandle_t fd, uint64_t pos);
+MDBX_INTERNAL_FUNC int mdbx_filesize(mdbx_filehandle_t fd, uint64_t *length);
+MDBX_INTERNAL_FUNC int mdbx_openfile(const char *pathname, int flags,
+ mode_t mode, mdbx_filehandle_t *fd,
+ bool exclusive);
+MDBX_INTERNAL_FUNC int mdbx_closefile(mdbx_filehandle_t fd);
+MDBX_INTERNAL_FUNC int mdbx_removefile(const char *pathname);
+MDBX_INTERNAL_FUNC int mdbx_is_pipe(mdbx_filehandle_t fd);
+
+typedef struct mdbx_mmap_param {
+ union {
+ void *address;
+ uint8_t *dxb;
+ struct MDBX_lockinfo *lck;
+ };
+ mdbx_filehandle_t fd;
+ size_t limit; /* mapping length, but NOT a size of file nor DB */
+ size_t current; /* mapped region size, i.e. the size of file and DB */
+#if defined(_WIN32) || defined(_WIN64)
+ uint64_t filesize /* in-process cache of a file size. */;
+#endif
+#ifdef MDBX_OSAL_SECTION
+ MDBX_OSAL_SECTION section;
+#endif
+} mdbx_mmap_t;
+
+MDBX_INTERNAL_FUNC int mdbx_mmap(const int flags, mdbx_mmap_t *map,
+ const size_t must, const size_t limit,
+ const bool truncate);
+MDBX_INTERNAL_FUNC int mdbx_munmap(mdbx_mmap_t *map);
+MDBX_INTERNAL_FUNC int mdbx_mresize(int flags, mdbx_mmap_t *map, size_t current,
+ size_t wanna);
+#if defined(_WIN32) || defined(_WIN64)
+typedef struct {
+ unsigned limit, count;
+ HANDLE handles[31];
+} mdbx_handle_array_t;
+MDBX_INTERNAL_FUNC int
+mdbx_suspend_threads_before_remap(MDBX_env *env, mdbx_handle_array_t **array);
+MDBX_INTERNAL_FUNC int
+mdbx_resume_threads_after_remap(mdbx_handle_array_t *array);
+#endif /* Windows */
+MDBX_INTERNAL_FUNC int mdbx_msync(mdbx_mmap_t *map, size_t offset,
+ size_t length, int async);
+MDBX_INTERNAL_FUNC int mdbx_check4nonlocal(mdbx_filehandle_t handle, int flags);
+
+static __maybe_unused __inline uint32_t mdbx_getpid(void) {
+ STATIC_ASSERT(sizeof(mdbx_pid_t) <= sizeof(uint32_t));
+#if defined(_WIN32) || defined(_WIN64)
+ return GetCurrentProcessId();
+#else
+ return getpid();
+#endif
+}
+
+static __maybe_unused __inline size_t mdbx_thread_self(void) {
+ STATIC_ASSERT(sizeof(mdbx_tid_t) <= sizeof(size_t));
+#if defined(_WIN32) || defined(_WIN64)
+ return GetCurrentThreadId();
+#else
+ return (size_t)pthread_self();
+#endif
+}
+
+MDBX_INTERNAL_FUNC void __maybe_unused mdbx_osal_jitter(bool tiny);
+MDBX_INTERNAL_FUNC uint64_t mdbx_osal_monotime(void);
+MDBX_INTERNAL_FUNC uint64_t
+mdbx_osal_16dot16_to_monotime(uint32_t seconds_16dot16);
+MDBX_INTERNAL_FUNC uint32_t mdbx_osal_monotime_to_16dot16(uint64_t monotime);
+
+typedef union bin128 {
+ __anonymous_struct_extension__ struct { uint64_t x, y; };
+ __anonymous_struct_extension__ struct { uint32_t a, b, c, d; };
+} bin128_t;
+
+MDBX_INTERNAL_FUNC bin128_t mdbx_osal_bootid(void);
+/*----------------------------------------------------------------------------*/
+/* lck stuff */
+
+#if defined(_WIN32) || defined(_WIN64)
+#undef MDBX_OSAL_LOCK
+#define MDBX_OSAL_LOCK_SIGN UINT32_C(0xF10C)
+#else
+#define MDBX_OSAL_LOCK pthread_mutex_t
+#define MDBX_OSAL_LOCK_SIGN UINT32_C(0x8017)
+#endif /* MDBX_OSAL_LOCK */
+
+/// \brief Initialization of synchronization primitives linked with MDBX_env
+/// instance both in LCK-file and within the current process.
+/// \param
+/// global_uniqueness_flag = true - denotes that there are no other processes
+/// working with DB and LCK-file. Thus the function MUST initialize
+/// shared synchronization objects in memory-mapped LCK-file.
+/// global_uniqueness_flag = false - denotes that at least one process is
+/// already working with DB and LCK-file, including the case when DB
+/// has already been opened in the current process. Thus the function
+/// MUST NOT initialize shared synchronization objects in memory-mapped
+/// LCK-file that are already in use.
+/// \return Error code or zero on success.
+MDBX_INTERNAL_FUNC int mdbx_lck_init(MDBX_env *env,
+ MDBX_env *inprocess_neighbor,
+ int global_uniqueness_flag);
+
+/// \brief Disconnects from shared interprocess objects and destructs
+/// synchronization objects linked with MDBX_env instance
+/// within the current process.
+/// \param
+/// inprocess_neighbor = NULL - if the current process does not have other
+/// instances of MDBX_env linked with the DB being closed.
+/// Thus the function MUST check for other processes working with DB or
+/// LCK-file, and keep or destroy shared synchronization objects in
+/// memory-mapped LCK-file depending on the result.
+/// inprocess_neighbor = not-NULL - pointer to another instance of MDBX_env
+/// (anyone of there is several) working with DB or LCK-file within the
+/// current process. Thus the function MUST NOT try to acquire exclusive
+/// lock and/or try to destruct shared synchronization objects linked with
+/// DB or LCK-file. Moreover, the implementation MUST ensure correct work
+/// of other instances of MDBX_env within the current process, e.g.
+/// restore POSIX-fcntl locks after the closing of file descriptors.
+/// \return Error code (MDBX_PANIC) or zero on success.
+MDBX_INTERNAL_FUNC int mdbx_lck_destroy(MDBX_env *env,
+ MDBX_env *inprocess_neighbor);
+
+/// \brief Connects to shared interprocess locking objects and tries to acquire
+/// the maximum lock level (shared if exclusive is not available)
+/// Depending on implementation or/and platform (Windows) this function may
+/// acquire the non-OS super-level lock (e.g. for shared synchronization
+/// objects initialization), which will be downgraded to OS-exclusive or
+/// shared via explicit calling of mdbx_lck_downgrade().
+/// \return
+/// MDBX_RESULT_TRUE (-1) - if an exclusive lock was acquired and thus
+/// the current process is the first and only after the last use of DB.
+/// MDBX_RESULT_FALSE (0) - if a shared lock was acquired and thus
+/// DB has already been opened and now is used by other processes.
+/// Otherwise (not 0 and not -1) - error code.
+MDBX_INTERNAL_FUNC int mdbx_lck_seize(MDBX_env *env);
+
+/// \brief Downgrades the level of initially acquired lock to
+/// operational level specified by agrument. The reson for such downgrade:
+/// - unblocking of other processes that are waiting for access, i.e.
+/// if (env->me_flags & MDBX_EXCLUSIVE) != 0, then other processes
+/// should be made aware that access is unavailable rather than
+/// wait for it.
+/// - freeing locks that interfere file operation (expecially for Windows)
+/// (env->me_flags & MDBX_EXCLUSIVE) == 0 - downgrade to shared lock.
+/// (env->me_flags & MDBX_EXCLUSIVE) != 0 - downgrade to exclusive
+/// operational lock.
+/// \return Error code or zero on success
+MDBX_INTERNAL_FUNC int mdbx_lck_downgrade(MDBX_env *env);
+
+/// \brief Locks LCK-file or/and table of readers for (de)registering.
+/// \return Error code or zero on success
+MDBX_INTERNAL_FUNC int mdbx_rdt_lock(MDBX_env *env);
+
+/// \brief Unlocks LCK-file or/and table of readers after (de)registering.
+MDBX_INTERNAL_FUNC void mdbx_rdt_unlock(MDBX_env *env);
+
+/// \brief Acquires lock for DB change (on writing transaction start)
+/// Reading transactions will not be blocked.
+/// Declared as LIBMDBX_API because it is used in mdbx_chk.
+/// \return Error code or zero on success
+LIBMDBX_API int mdbx_txn_lock(MDBX_env *env, bool dontwait);
+
+/// \brief Releases lock once DB changes is made (after writing transaction
+/// has finished).
+/// Declared as LIBMDBX_API because it is used in mdbx_chk.
+LIBMDBX_API void mdbx_txn_unlock(MDBX_env *env);
+
+/// \brief Sets alive-flag of reader presence (indicative lock) for PID of
+/// the current process. The function does no more than needed for
+/// the correct working of mdbx_rpid_check() in other processes.
+/// \return Error code or zero on success
+MDBX_INTERNAL_FUNC int mdbx_rpid_set(MDBX_env *env);
+
+/// \brief Resets alive-flag of reader presence (indicative lock)
+/// for PID of the current process. The function does no more than needed
+/// for the correct working of mdbx_rpid_check() in other processes.
+/// \return Error code or zero on success
+MDBX_INTERNAL_FUNC int mdbx_rpid_clear(MDBX_env *env);
+
+/// \brief Checks for reading process status with the given pid with help of
+/// alive-flag of presence (indicative lock) or using another way.
+/// \return
+/// MDBX_RESULT_TRUE (-1) - if the reader process with the given PID is alive
+/// and working with DB (indicative lock is present).
+/// MDBX_RESULT_FALSE (0) - if the reader process with the given PID is absent
+/// or not working with DB (indicative lock is not present).
+/// Otherwise (not 0 and not -1) - error code.
+MDBX_INTERNAL_FUNC int mdbx_rpid_check(MDBX_env *env, uint32_t pid);
+
+#if defined(_WIN32) || defined(_WIN64)
+typedef union MDBX_srwlock {
+ struct {
+ long volatile readerCount;
+ long volatile writerCount;
+ };
+ RTL_SRWLOCK native;
+} MDBX_srwlock;
+
+typedef void(WINAPI *MDBX_srwlock_function)(MDBX_srwlock *);
+MDBX_INTERNAL_VAR MDBX_srwlock_function mdbx_srwlock_Init,
+ mdbx_srwlock_AcquireShared, mdbx_srwlock_ReleaseShared,
+ mdbx_srwlock_AcquireExclusive, mdbx_srwlock_ReleaseExclusive;
+
+typedef BOOL(WINAPI *MDBX_GetFileInformationByHandleEx)(
+ _In_ HANDLE hFile, _In_ FILE_INFO_BY_HANDLE_CLASS FileInformationClass,
+ _Out_ LPVOID lpFileInformation, _In_ DWORD dwBufferSize);
+MDBX_INTERNAL_VAR MDBX_GetFileInformationByHandleEx
+ mdbx_GetFileInformationByHandleEx;
+
+typedef BOOL(WINAPI *MDBX_GetVolumeInformationByHandleW)(
+ _In_ HANDLE hFile, _Out_opt_ LPWSTR lpVolumeNameBuffer,
+ _In_ DWORD nVolumeNameSize, _Out_opt_ LPDWORD lpVolumeSerialNumber,
+ _Out_opt_ LPDWORD lpMaximumComponentLength,
+ _Out_opt_ LPDWORD lpFileSystemFlags,
+ _Out_opt_ LPWSTR lpFileSystemNameBuffer, _In_ DWORD nFileSystemNameSize);
+MDBX_INTERNAL_VAR MDBX_GetVolumeInformationByHandleW
+ mdbx_GetVolumeInformationByHandleW;
+
+typedef DWORD(WINAPI *MDBX_GetFinalPathNameByHandleW)(_In_ HANDLE hFile,
+ _Out_ LPWSTR lpszFilePath,
+ _In_ DWORD cchFilePath,
+ _In_ DWORD dwFlags);
+MDBX_INTERNAL_VAR MDBX_GetFinalPathNameByHandleW mdbx_GetFinalPathNameByHandleW;
+
+typedef BOOL(WINAPI *MDBX_SetFileInformationByHandle)(
+ _In_ HANDLE hFile, _In_ FILE_INFO_BY_HANDLE_CLASS FileInformationClass,
+ _Out_ LPVOID lpFileInformation, _In_ DWORD dwBufferSize);
+MDBX_INTERNAL_VAR MDBX_SetFileInformationByHandle
+ mdbx_SetFileInformationByHandle;
+
+typedef NTSTATUS(NTAPI *MDBX_NtFsControlFile)(
+ IN HANDLE FileHandle, IN OUT HANDLE Event,
+ IN OUT PVOID /* PIO_APC_ROUTINE */ ApcRoutine, IN OUT PVOID ApcContext,
+ OUT PIO_STATUS_BLOCK IoStatusBlock, IN ULONG FsControlCode,
+ IN OUT PVOID InputBuffer, IN ULONG InputBufferLength,
+ OUT OPTIONAL PVOID OutputBuffer, IN ULONG OutputBufferLength);
+MDBX_INTERNAL_VAR MDBX_NtFsControlFile mdbx_NtFsControlFile;
+
+typedef uint64_t(WINAPI *MDBX_GetTickCount64)(void);
+MDBX_INTERNAL_VAR MDBX_GetTickCount64 mdbx_GetTickCount64;
+
+#if !defined(_WIN32_WINNT_WIN8) || _WIN32_WINNT < _WIN32_WINNT_WIN8
+typedef struct _WIN32_MEMORY_RANGE_ENTRY {
+ PVOID VirtualAddress;
+ SIZE_T NumberOfBytes;
+} WIN32_MEMORY_RANGE_ENTRY, *PWIN32_MEMORY_RANGE_ENTRY;
+#endif /* Windows 8.x */
+
+typedef BOOL(WINAPI *MDBX_PrefetchVirtualMemory)(
+ HANDLE hProcess, ULONG_PTR NumberOfEntries,
+ PWIN32_MEMORY_RANGE_ENTRY VirtualAddresses, ULONG Flags);
+MDBX_INTERNAL_VAR MDBX_PrefetchVirtualMemory mdbx_PrefetchVirtualMemory;
+
+#if 0 /* LY: unused for now */
+#if !defined(_WIN32_WINNT_WIN81) || _WIN32_WINNT < _WIN32_WINNT_WIN81
+typedef enum OFFER_PRIORITY {
+ VmOfferPriorityVeryLow = 1,
+ VmOfferPriorityLow,
+ VmOfferPriorityBelowNormal,
+ VmOfferPriorityNormal
+} OFFER_PRIORITY;
+#endif /* Windows 8.1 */
+
+typedef DWORD(WINAPI *MDBX_DiscardVirtualMemory)(PVOID VirtualAddress,
+ SIZE_T Size);
+MDBX_INTERNAL_VAR MDBX_DiscardVirtualMemory mdbx_DiscardVirtualMemory;
+
+typedef DWORD(WINAPI *MDBX_ReclaimVirtualMemory)(PVOID VirtualAddress,
+ SIZE_T Size);
+MDBX_INTERNAL_VAR MDBX_ReclaimVirtualMemory mdbx_ReclaimVirtualMemory;
+
+typedef DWORD(WINAPI *MDBX_OfferVirtualMemory(
+ PVOID VirtualAddress,
+ SIZE_T Size,
+ OFFER_PRIORITY Priority
+);
+MDBX_INTERNAL_VAR MDBX_OfferVirtualMemory mdbx_OfferVirtualMemory;
+#endif /* unused for now */
+
+#endif /* Windows */
+
+/*----------------------------------------------------------------------------*/
+/* Atomics */
+
+#if !defined(__cplusplus) && (__STDC_VERSION__ >= 201112L) && \
+ !defined(__STDC_NO_ATOMICS__) && \
+ (__GNUC_PREREQ(4, 9) || __CLANG_PREREQ(3, 8) || \
+ !(defined(__GNUC__) || defined(__clang__)))
+#include
+#elif defined(__GNUC__) || defined(__clang__)
+/* LY: nothing required */
+#elif defined(_MSC_VER)
+#pragma warning(disable : 4163) /* 'xyz': not available as an intrinsic */
+#pragma warning(disable : 4133) /* 'function': incompatible types - from \
+ 'size_t' to 'LONGLONG' */
+#pragma warning(disable : 4244) /* 'return': conversion from 'LONGLONG' to \
+ 'std::size_t', possible loss of data */
+#pragma warning(disable : 4267) /* 'function': conversion from 'size_t' to \
+ 'long', possible loss of data */
+#pragma intrinsic(_InterlockedExchangeAdd, _InterlockedCompareExchange)
+#pragma intrinsic(_InterlockedExchangeAdd64, _InterlockedCompareExchange64)
+#elif defined(__APPLE__)
+#include
+#else
+#error FIXME atomic-ops
+#endif
+
+/*----------------------------------------------------------------------------*/
+
+#if defined(_MSC_VER) && _MSC_VER >= 1900
+/* LY: MSVC 2015/2017/2019 has buggy/inconsistent PRIuPTR/PRIxPTR macros
+ * for internal format-args checker. */
+#undef PRIuPTR
+#undef PRIiPTR
+#undef PRIdPTR
+#undef PRIxPTR
+#define PRIuPTR "Iu"
+#define PRIiPTR "Ii"
+#define PRIdPTR "Id"
+#define PRIxPTR "Ix"
+#define PRIuSIZE "zu"
+#define PRIiSIZE "zi"
+#define PRIdSIZE "zd"
+#define PRIxSIZE "zx"
+#endif /* fix PRI*PTR for _MSC_VER */
+
+#ifndef PRIuSIZE
+#define PRIuSIZE PRIuPTR
+#define PRIiSIZE PRIiPTR
+#define PRIdSIZE PRIdPTR
+#define PRIxSIZE PRIxPTR
+#endif /* PRI*SIZE macros for MSVC */
+
+#ifdef _MSC_VER
+#pragma warning(pop)
+#endif
diff --git a/contrib/db/libmdbx/src/elements/version.c.in b/contrib/db/libmdbx/src/elements/version.c.in
new file mode 100644
index 00000000..356b1857
--- /dev/null
+++ b/contrib/db/libmdbx/src/elements/version.c.in
@@ -0,0 +1,46 @@
+/* This is CMake-template for libmdbx's version.c
+ ******************************************************************************/
+
+#include "internals.h"
+
+//#if MDBX_VERSION_MAJOR != ${MDBX_VERSION_MAJOR} || \
+// MDBX_VERSION_MINOR != ${MDBX_VERSION_MINOR}
+//#error "API version mismatch! Had `git fetch --tags` done?"
+//#endif
+
+static const char sourcery[] = STRINGIFY(MDBX_BUILD_SOURCERY);
+
+__dll_export
+#ifdef __attribute_used__
+ __attribute_used__
+#elif defined(__GNUC__) || __has_attribute(__used__)
+ __attribute__((__used__))
+#endif
+#ifdef __attribute_externally_visible__
+ __attribute_externally_visible__
+#elif (defined(__GNUC__) && !defined(__clang__)) || \
+ __has_attribute(__externally_visible__)
+ __attribute__((__externally_visible__))
+#endif
+ const mdbx_version_info mdbx_version = {
+ ${MDBX_VERSION_MAJOR},
+ ${MDBX_VERSION_MINOR},
+ ${MDBX_VERSION_RELEASE},
+ ${MDBX_VERSION_REVISION},
+ {"@MDBX_GIT_TIMESTAMP@", "@MDBX_GIT_TREE@", "@MDBX_GIT_COMMIT@",
+ "@MDBX_GIT_DESCRIBE@"},
+ sourcery};
+
+__dll_export
+#ifdef __attribute_used__
+ __attribute_used__
+#elif defined(__GNUC__) || __has_attribute(__used__)
+ __attribute__((__used__))
+#endif
+#ifdef __attribute_externally_visible__
+ __attribute_externally_visible__
+#elif (defined(__GNUC__) && !defined(__clang__)) || \
+ __has_attribute(__externally_visible__)
+ __attribute__((__externally_visible__))
+#endif
+ const char *const mdbx_sourcery_anchor = sourcery;
diff --git a/contrib/db/libmdbx/src/man1/mdbx_chk.1 b/contrib/db/libmdbx/src/man1/mdbx_chk.1
new file mode 100644
index 00000000..84b10a1f
--- /dev/null
+++ b/contrib/db/libmdbx/src/man1/mdbx_chk.1
@@ -0,0 +1,87 @@
+.\" Copyright 2015-2019 Leonid Yuriev .
+.\" Copying restrictions apply. See COPYRIGHT/LICENSE.
+.TH MDBX_CHK 1 "2019-09-10" "MDBX 0.x"
+.SH NAME
+mdbx_chk \- MDBX checking tool
+.SH SYNOPSIS
+.B mdbx_chk
+[\c
+.BR \-V ]
+[\c
+.BR \-v [ v [ v ]]]
+[\c
+.BR \-n ]
+[\c
+.BR \-q ]
+[\c
+.BR \-w ]
+[\c
+.BR \-d ]
+[\c
+.BI \-s \ subdb\fR]
+[\c
+.BR \-c ]
+[\c
+.BR \-i ]
+.BR \ envpath
+.SH DESCRIPTION
+The
+.B mdbx_chk
+utility intended to check an MDBX database file.
+.SH OPTIONS
+.TP
+.BR \-V
+Write the library version number to the standard output, and exit.
+.TP
+.BR \-v
+Produce verbose output, including summarize space and page usage statistics.
+If \fB\-vv\fP is given, be more verbose, show summarized B-tree info
+and space allocation.
+If \fB\-vvv\fP is given, be more verbose, include summarized statistics
+of leaf B-tree pages.
+If \fB\-vvvv\fP is given, be even more verbose, show info of each page
+during B-tree traversal and basic info of each GC record.
+If \fB\-vvvvv\fP is given, turn maximal verbosity, display the full list
+of page IDs in the GC records and size of each key-value pair of database(s).
+.TP
+.BR \-n
+Open MDBX environment(s) which do not use subdirectories.
+.TP
+.BR \-q
+Be quiet; do not output anything even if an error was detected.
+.TP
+.BR \-w
+Open environment in read-write mode and lock for writing while checking.
+This could be impossible if environment already used by another process(s)
+in an incompatible read-write mode. This allow rollback to last steady commit
+(in case environment was not closed properly) and then check transaction IDs
+of meta-pages. Otherwise, without \fB\-w\fP option environment will be
+opened in read-only mode.
+.TP
+.BR \-d
+Disable page-by-page traversal of B-tree. In this case, without B-tree
+traversal, it is unable to check for lost-unused pages nor for double-used
+pages.
+.TP
+.BR \-s \ subdb
+Verify and show info only for a specific subdatabase.
+.TP
+.BR \-c
+Force using cooperative mode while opening environment, i.e. don't try to open
+in exclusive/monopolistic mode. Only exclusive/monopolistic mode allow complete
+check, including full check of all meta-pages and actual size of database file.
+.TP
+.BR \-i
+Ignore wrong order errors, which will likely false-positive if custom
+comparator(s) was used.
+.SH DIAGNOSTICS
+Exit status is zero if no errors occur. Errors result in a non-zero exit status
+and a diagnostic message being written to standard error
+if no quiet mode was requested.
+.SH "SEE ALSO"
+.BR mdbx_stat (1),
+.BR mdbx_copy (1),
+.BR mdbx_dump (1),
+.BR mdbx_load (1)
+.SH AUTHOR
+Leonid Yuriev
diff --git a/contrib/db/libmdbx/src/man1/mdbx_copy.1 b/contrib/db/libmdbx/src/man1/mdbx_copy.1
new file mode 100644
index 00000000..08717bca
--- /dev/null
+++ b/contrib/db/libmdbx/src/man1/mdbx_copy.1
@@ -0,0 +1,60 @@
+.\" Copyright 2015-2019 Leonid Yuriev .
+.\" Copyright 2012-2015 Howard Chu, Symas Corp. All Rights Reserved.
+.\" Copyright 2015,2016 Peter-Service R&D LLC .
+.\" Copying restrictions apply. See COPYRIGHT/LICENSE.
+.TH MDBX_COPY 1 "2019-09-10" "MDBX 0.x"
+.SH NAME
+mdbx_copy \- MDBX environment copy tool
+.SH SYNOPSIS
+.B mdbx_copy
+[\c
+.BR \-V ]
+[\c
+.BR \-c ]
+[\c
+.BR \-n ]
+.B srcpath
+[\c
+.BR dstpath ]
+.SH DESCRIPTION
+The
+.B mdbx_copy
+utility copies an MDBX environment. The environment can
+be copied regardless of whether it is currently in use.
+No lockfile is created, since it gets recreated at need.
+
+If
+.I dstpath
+is specified it must be the path of an empty directory
+for storing the backup. Otherwise, the backup will be
+written to stdout.
+
+.SH OPTIONS
+.TP
+.BR \-V
+Write the library version number to the standard output, and exit.
+.TP
+.BR \-c
+Compact while copying. Only current data pages will be copied; freed
+or unused pages will be omitted from the copy. This option will
+slow down the backup process as it is more CPU-intensive.
+Currently it fails if the environment has suffered a page leak.
+.TP
+.BR \-n
+Open MDBX environment(s) which do not use subdirectories.
+
+.SH DIAGNOSTICS
+Exit status is zero if no errors occur.
+Errors result in a non-zero exit status and
+a diagnostic message being written to standard error.
+.SH CAVEATS
+This utility can trigger significant file size growth if run
+in parallel with write transactions, because pages which they
+free during copying cannot be reused until the copy is done.
+.SH "SEE ALSO"
+.BR mdbx_dump (1),
+.BR mdbx_chk (1),
+.BR mdbx_stat (1),
+.BR mdbx_load (1)
+.SH AUTHOR
+Howard Chu of Symas Corporation
diff --git a/contrib/db/libmdbx/src/man1/mdbx_dump.1 b/contrib/db/libmdbx/src/man1/mdbx_dump.1
new file mode 100644
index 00000000..0e5ecf66
--- /dev/null
+++ b/contrib/db/libmdbx/src/man1/mdbx_dump.1
@@ -0,0 +1,80 @@
+.\" Copyright 2015-2019 Leonid Yuriev .
+.\" Copyright 2014-2015 Howard Chu, Symas Corp. All Rights Reserved.
+.\" Copyright 2015,2016 Peter-Service R&D LLC .
+.\" Copying restrictions apply. See COPYRIGHT/LICENSE.
+.TH MDBX_DUMP 1 "2019-09-10" "MDBX 0.x"
+.SH NAME
+mdbx_dump \- MDBX environment export tool
+.SH SYNOPSIS
+.B mdbx_dump
+[\c
+.BR \-V ]
+[\c
+.BI \-f \ file\fR]
+[\c
+.BR \-l ]
+[\c
+.BR \-n ]
+[\c
+.BR \-p ]
+[\c
+.BR \-a \ |
+.BI \-s \ subdb\fR]
+.BR \ envpath
+.SH DESCRIPTION
+The
+.B mdbx_dump
+utility reads a database and writes its contents to the
+standard output using a portable flat-text format
+understood by the
+.BR mdbx_load (1)
+utility.
+.SH OPTIONS
+.TP
+.BR \-V
+Write the library version number to the standard output, and exit.
+.TP
+.BR \-f \ file
+Write to the specified file instead of to the standard output.
+.TP
+.BR \-l
+List the databases stored in the environment. Just the
+names will be listed, no data will be output.
+.TP
+.BR \-n
+Dump an MDBX database which does not use subdirectories.
+.TP
+.BR \-p
+If characters in either the key or data items are printing characters (as
+defined by isprint(3)), output them directly. This option permits users to
+use standard text editors and tools to modify the contents of databases.
+
+Note: different systems may have different notions about what characters
+are considered printing characters, and databases dumped in this manner may
+be less portable to external systems.
+.TP
+.BR \-a
+Dump all of the subdatabases in the environment.
+.TP
+.BR \-s \ subdb
+Dump a specific subdatabase. If no database is specified, only the main database is dumped.
+.SH DIAGNOSTICS
+Exit status is zero if no errors occur.
+Errors result in a non-zero exit status and
+a diagnostic message being written to standard error.
+
+Dumping and reloading databases that use user-defined comparison functions
+will result in new databases that use the default comparison functions.
+\fBIn this case it is quite likely that the reloaded database will be
+damaged beyond repair permitting neither record storage nor retrieval.\fP
+
+The only available workaround is to modify the source for the
+.BR mdbx_load (1)
+utility to load the database using the correct comparison functions.
+.SH "SEE ALSO"
+.BR mdbx_load (1),
+.BR mdbx_copy (1),
+.BR mdbx_chk (1),
+.BR mdbx_stat (1)
+.SH AUTHOR
+Howard Chu of Symas Corporation
diff --git a/contrib/db/libmdbx/src/man1/mdbx_load.1 b/contrib/db/libmdbx/src/man1/mdbx_load.1
new file mode 100644
index 00000000..01b03eff
--- /dev/null
+++ b/contrib/db/libmdbx/src/man1/mdbx_load.1
@@ -0,0 +1,89 @@
+.\" Copyright 2015-2019 Leonid Yuriev .
+.\" Copyright 2014-2015 Howard Chu, Symas Corp. All Rights Reserved.
+.\" Copyright 2015,2016 Peter-Service R&D LLC .
+.\" Copying restrictions apply. See COPYRIGHT/LICENSE.
+.TH MDBX_LOAD 1 "2019-09-10" "MDBX 0.x"
+.SH NAME
+mdbx_load \- MDBX environment import tool
+.SH SYNOPSIS
+.B mdbx_load
+[\c
+.BR \-V ]
+[\c
+.BI \-f \ file\fR]
+[\c
+.BR \-n ]
+[\c
+.BI \-s \ subdb\fR]
+[\c
+.BR \-N ]
+[\c
+.BR \-T ]
+.BR \ envpath
+.SH DESCRIPTION
+The
+.B mdbx_load
+utility reads from the standard input and loads it into the
+MDBX environment
+.BR envpath .
+
+The input to
+.B mdbx_load
+must be in the output format specified by the
+.BR mdbx_dump (1)
+utility or as specified by the
+.B -T
+option below.
+.SH OPTIONS
+.TP
+.BR \-V
+Write the library version number to the standard output, and exit.
+.TP
+.BR \-a
+Append all records in the order they appear in the input. The input is assumed to already be
+in correctly sorted order and no sorting or checking for redundant values will be performed.
+This option must be used to reload data that was produced by running
+.B mdbx_dump
+on a database that uses custom compare functions.
+.TP
+.BR \-f \ file
+Read from the specified file instead of from the standard input.
+.TP
+.BR \-n
+Load an MDBX database which does not use subdirectories.
+.TP
+.BR \-s \ subdb
+Load a specific subdatabase. If no database is specified, data is loaded into the main database.
+.TP
+.BR \-N
+Don't overwrite existing records when loading into an already existing database; just skip them.
+.TP
+.BR \-T
+Load data from simple text files. The input must be paired lines of text, where the first
+line of the pair is the key item, and the second line of the pair is its corresponding
+data item.
+
+A simple escape mechanism, where newline and backslash (\\) characters are special, is
+applied to the text input. Newline characters are interpreted as record separators.
+Backslash characters in the text will be interpreted in one of two ways: If the backslash
+character precedes another backslash character, the pair will be interpreted as a literal
+backslash. If the backslash character precedes any other character, the two characters
+following the backslash will be interpreted as a hexadecimal specification of a single
+character; for example, \\0a is a newline character in the ASCII character set.
+
+For this reason, any backslash or newline characters that naturally occur in the text
+input must be escaped to avoid misinterpretation by
+.BR mdbx_load .
+
+.SH DIAGNOSTICS
+Exit status is zero if no errors occur.
+Errors result in a non-zero exit status and
+a diagnostic message being written to standard error.
+
+.SH "SEE ALSO"
+.BR mdbx_dump (1),
+.BR mdbx_chk (1),
+.BR mdbx_stat (1),
+.BR mdbx_copy (1)
+.SH AUTHOR
+Howard Chu of Symas Corporation
diff --git a/contrib/db/libmdbx/src/man1/mdbx_stat.1 b/contrib/db/libmdbx/src/man1/mdbx_stat.1
new file mode 100644
index 00000000..424e76c0
--- /dev/null
+++ b/contrib/db/libmdbx/src/man1/mdbx_stat.1
@@ -0,0 +1,69 @@
+.\" Copyright 2015-2019 Leonid Yuriev .
+.\" Copyright 2012-2015 Howard Chu, Symas Corp. All Rights Reserved.
+.\" Copyright 2015,2016 Peter-Service R&D LLC .
+.\" Copying restrictions apply. See COPYRIGHT/LICENSE.
+.TH MDBX_STAT 1 "2019-09-10" "MDBX 0.x"
+.SH NAME
+mdbx_stat \- MDBX environment status tool
+.SH SYNOPSIS
+.B mdbx_stat
+[\c
+.BR \-V ]
+[\c
+.BR \-e ]
+[\c
+.BR \-f [ f [ f ]]]
+[\c
+.BR \-n ]
+[\c
+.BR \-r [ r ]]
+[\c
+.BR \-a \ |
+.BI \-s \ subdb\fR]
+.BR \ envpath
+.SH DESCRIPTION
+The
+.B mdbx_stat
+utility displays the status of an MDBX environment.
+.SH OPTIONS
+.TP
+.BR \-V
+Write the library version number to the standard output, and exit.
+.TP
+.BR \-e
+Display information about the database environment.
+.TP
+.BR \-f
+Display information about the environment freelist.
+If \fB\-ff\fP is given, summarize each freelist entry.
+If \fB\-fff\fP is given, display the full list of page IDs in the freelist.
+.TP
+.BR \-n
+Display the status of an MDBX database which does not use subdirectories.
+.TP
+.BR \-r
+Display information about the environment reader table.
+Shows the process ID, thread ID, and transaction ID for each active
+reader slot. The process ID and transaction ID are in decimal, the
+thread ID is in hexadecimal. The transaction ID is displayed as "-"
+if the reader does not currently have a read transaction open.
+If \fB\-rr\fP is given, check for stale entries in the reader
+table and clear them. The reader table will be printed again
+after the check is performed.
+.TP
+.BR \-a
+Display the status of all of the subdatabases in the environment.
+.TP
+.BR \-s \ subdb
+Display the status of a specific subdatabase.
+.SH DIAGNOSTICS
+Exit status is zero if no errors occur.
+Errors result in a non-zero exit status and
+a diagnostic message being written to standard error.
+.SH "SEE ALSO"
+.BR mdbx_chk (1),
+.BR mdbx_copy (1),
+.BR mdbx_dump (1),
+.BR mdbx_load (1)
+.SH AUTHOR
+Howard Chu of Symas Corporation
diff --git a/contrib/db/libmdbx/src/tools/CMakeLists.txt b/contrib/db/libmdbx/src/tools/CMakeLists.txt
new file mode 100644
index 00000000..01ecd7dd
--- /dev/null
+++ b/contrib/db/libmdbx/src/tools/CMakeLists.txt
@@ -0,0 +1,42 @@
+set(MDBX_TOOLS mdbx_chk mdbx_copy mdbx_dump mdbx_load mdbx_stat)
+
+# use, i.e. don't skip the full RPATH for the build tree
+set(CMAKE_SKIP_BUILD_RPATH FALSE)
+
+# when building, don't use the install RPATH already (but later on when installing)
+set(CMAKE_BUILD_WITH_INSTALL_RPATH FALSE)
+
+# add the automatically determined parts of the RPATH
+# which point to directories outside the build tree to the install RPATH
+set(CMAKE_INSTALL_RPATH_USE_LINK_PATH TRUE)
+
+# the RPATH to be used when installing, but only if it's not a system directory
+list(FIND CMAKE_PLATFORM_IMPLICIT_LINK_DIRECTORIES "${CMAKE_INSTALL_PREFIX}/lib" isSystemDir)
+if(isSystemDir EQUAL -1)
+ if(${CMAKE_SYSTEM_NAME} STREQUAL "Darwin")
+ set(CMAKE_INSTALL_RPATH "@executable_path/../lib")
+ else()
+ set(CMAKE_INSTALL_RPATH "\$ORIGIN/../lib")
+ endif()
+endif()
+
+foreach(TOOL ${MDBX_TOOLS})
+ if(${CMAKE_SYSTEM_NAME} STREQUAL "Windows")
+ add_executable(${TOOL} ${TOOL}.c wingetopt.c wingetopt.h)
+ else()
+ add_executable(${TOOL} ${TOOL}.c)
+ endif()
+
+ target_link_libraries(${TOOL} mdbx ${CMAKE_THREAD_LIBS_INIT})
+ set_target_properties(${TOOL} PROPERTIES
+ C_STANDARD ${MDBX_C_STANDARD} C_STANDARD_REQUIRED ON
+ INTERPROCEDURAL_OPTIMIZATION $)
+
+ install(TARGETS ${TOOL} DESTINATION ${CMAKE_INSTALL_PREFIX}/bin COMPONENT mdbx)
+ install(FILES ${CMAKE_CURRENT_SOURCE_DIR}/../man1/${TOOL}.1 DESTINATION ${CMAKE_INSTALL_PREFIX}/man/man1 COMPONENT mdbx)
+endforeach()
+
+if(LIB_MATH)
+ target_link_libraries(mdbx_chk ${LIB_MATH})
+ target_link_libraries(mdbx_stat ${LIB_MATH})
+endif()
diff --git a/contrib/db/libmdbx/src/tools/mdbx_chk.c b/contrib/db/libmdbx/src/tools/mdbx_chk.c
new file mode 100644
index 00000000..cd61e44e
--- /dev/null
+++ b/contrib/db/libmdbx/src/tools/mdbx_chk.c
@@ -0,0 +1,1430 @@
+/* mdbx_chk.c - memory-mapped database check tool */
+
+/*
+ * Copyright 2015-2019 Leonid Yuriev
+ * and other libmdbx authors: please see AUTHORS file.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted only as authorized by the OpenLDAP
+ * Public License.
+ *
+ * A copy of this license is available in the file LICENSE in the
+ * top-level directory of the distribution or, alternatively, at
+ * . */
+
+#ifdef _MSC_VER
+#if _MSC_VER > 1800
+#pragma warning(disable : 4464) /* relative include path contains '..' */
+#endif
+#pragma warning(disable : 4996) /* The POSIX name is deprecated... */
+#endif /* _MSC_VER (warnings) */
+
+#define MDBX_TOOLS /* Avoid using internal mdbx_assert() */
+#include "../elements/internals.h"
+
+typedef struct flagbit {
+ int bit;
+ char *name;
+} flagbit;
+
+flagbit dbflags[] = {{MDBX_DUPSORT, "dupsort"},
+ {MDBX_INTEGERKEY, "integerkey"},
+ {MDBX_REVERSEKEY, "reversekey"},
+ {MDBX_DUPFIXED, "dupfixed"},
+ {MDBX_REVERSEDUP, "reversedup"},
+ {MDBX_INTEGERDUP, "integerdup"},
+ {0, NULL}};
+
+#if defined(_WIN32) || defined(_WIN64)
+#include "wingetopt.h"
+
+static volatile BOOL user_break;
+static BOOL WINAPI ConsoleBreakHandlerRoutine(DWORD dwCtrlType) {
+ (void)dwCtrlType;
+ user_break = true;
+ return true;
+}
+
+#else /* WINDOWS */
+
+static volatile sig_atomic_t user_break;
+static void signal_handler(int sig) {
+ (void)sig;
+ user_break = 1;
+}
+
+#endif /* !WINDOWS */
+
+#define EXIT_INTERRUPTED (EXIT_FAILURE + 4)
+#define EXIT_FAILURE_SYS (EXIT_FAILURE + 3)
+#define EXIT_FAILURE_MDB (EXIT_FAILURE + 2)
+#define EXIT_FAILURE_CHECK_MAJOR (EXIT_FAILURE + 1)
+#define EXIT_FAILURE_CHECK_MINOR EXIT_FAILURE
+
+typedef struct {
+ const char *name;
+ struct {
+ uint64_t branch, large_count, large_volume, leaf;
+ uint64_t subleaf_dupsort, leaf_dupfixed, subleaf_dupfixed;
+ uint64_t total, empty, other;
+ } pages;
+ uint64_t payload_bytes;
+ uint64_t lost_bytes;
+} walk_dbi_t;
+
+struct {
+ short *pagemap;
+ uint64_t total_payload_bytes;
+ uint64_t pgcount;
+ walk_dbi_t dbi[MAX_DBI + CORE_DBS + /* account pseudo-entry for meta */ 1];
+} walk;
+
+#define dbi_free walk.dbi[FREE_DBI]
+#define dbi_main walk.dbi[MAIN_DBI]
+#define dbi_meta walk.dbi[CORE_DBS]
+
+uint64_t total_unused_bytes;
+int envflags = MDBX_RDONLY | MDBX_EXCLUSIVE;
+
+MDBX_env *env;
+MDBX_txn *txn;
+MDBX_envinfo envinfo;
+MDBX_stat envstat;
+size_t maxkeysize, userdb_count, skipped_subdb;
+uint64_t reclaimable_pages, gc_pages, alloc_pages, unused_pages, backed_pages;
+unsigned verbose;
+bool ignore_wrong_order, quiet;
+const char *only_subdb;
+
+struct problem {
+ struct problem *pr_next;
+ size_t count;
+ const char *caption;
+};
+
+struct problem *problems_list;
+uint64_t total_problems;
+
+static void __printf_args(1, 2) print(const char *msg, ...) {
+ if (!quiet) {
+ va_list args;
+
+ fflush(stderr);
+ va_start(args, msg);
+ vfprintf(stdout, msg, args);
+ va_end(args);
+ }
+}
+
+static void __printf_args(1, 2) error(const char *msg, ...) {
+ total_problems++;
+
+ if (!quiet) {
+ va_list args;
+
+ fflush(NULL);
+ va_start(args, msg);
+ fputs(" ! ", stderr);
+ vfprintf(stderr, msg, args);
+ va_end(args);
+ fflush(NULL);
+ }
+}
+
+static void pagemap_cleanup(void) {
+ for (size_t i = CORE_DBS + /* account pseudo-entry for meta */ 1;
+ i < ARRAY_LENGTH(walk.dbi); ++i) {
+ if (walk.dbi[i].name) {
+ mdbx_free((void *)walk.dbi[i].name);
+ walk.dbi[i].name = NULL;
+ }
+ }
+
+ mdbx_free(walk.pagemap);
+ walk.pagemap = NULL;
+}
+
+static walk_dbi_t *pagemap_lookup_dbi(const char *dbi_name, bool silent) {
+ static walk_dbi_t *last;
+
+ if (dbi_name == MDBX_PGWALK_MAIN)
+ return &dbi_main;
+ if (dbi_name == MDBX_PGWALK_GC)
+ return &dbi_free;
+ if (dbi_name == MDBX_PGWALK_META)
+ return &dbi_meta;
+
+ if (last && strcmp(last->name, dbi_name) == 0)
+ return last;
+
+ walk_dbi_t *dbi = walk.dbi + CORE_DBS + /* account pseudo-entry for meta */ 1;
+ for (; dbi < ARRAY_END(walk.dbi) && dbi->name; ++dbi) {
+ if (strcmp(dbi->name, dbi_name) == 0)
+ return last = dbi;
+ }
+
+ if (verbose > 0 && !silent) {
+ print(" - found '%s' area\n", dbi_name);
+ fflush(NULL);
+ }
+
+ if (dbi == ARRAY_END(walk.dbi))
+ return NULL;
+
+ dbi->name = mdbx_strdup(dbi_name);
+ return last = dbi;
+}
+
+static void __printf_args(4, 5)
+
+ problem_add(const char *object, uint64_t entry_number, const char *msg,
+ const char *extra, ...) {
+ total_problems++;
+
+ if (!quiet) {
+ int need_fflush = 0;
+ struct problem *p;
+
+ for (p = problems_list; p; p = p->pr_next)
+ if (p->caption == msg)
+ break;
+
+ if (!p) {
+ p = mdbx_calloc(1, sizeof(*p));
+ p->caption = msg;
+ p->pr_next = problems_list;
+ problems_list = p;
+ need_fflush = 1;
+ }
+
+ p->count++;
+ if (verbose > 1) {
+ print(" %s #%" PRIu64 ": %s", object, entry_number, msg);
+ if (extra) {
+ va_list args;
+ printf(" (");
+ va_start(args, extra);
+ vfprintf(stdout, extra, args);
+ va_end(args);
+ printf(")");
+ }
+ printf("\n");
+ if (need_fflush)
+ fflush(NULL);
+ }
+ }
+}
+
+static struct problem *problems_push(void) {
+ struct problem *p = problems_list;
+ problems_list = NULL;
+ return p;
+}
+
+static size_t problems_pop(struct problem *list) {
+ size_t count = 0;
+
+ if (problems_list) {
+ int i;
+
+ print(" - problems: ");
+ for (i = 0; problems_list; ++i) {
+ struct problem *p = problems_list->pr_next;
+ count += problems_list->count;
+ print("%s%s (%" PRIuPTR ")", i ? ", " : "", problems_list->caption,
+ problems_list->count);
+ mdbx_free(problems_list);
+ problems_list = p;
+ }
+ print("\n");
+ fflush(NULL);
+ }
+
+ problems_list = list;
+ return count;
+}
+
+static int pgvisitor(const uint64_t pgno, const unsigned pgnumber,
+ void *const ctx, const int deep,
+ const char *const dbi_name_or_tag, const size_t page_size,
+ const MDBX_page_type_t pagetype, const size_t nentries,
+ const size_t payload_bytes, const size_t header_bytes,
+ const size_t unused_bytes) {
+ (void)ctx;
+ if (deep > 42) {
+ problem_add("deep", deep, "too large", nullptr);
+ return MDBX_CORRUPTED /* avoid infinite loop/recursion */;
+ }
+
+ if (pagetype == MDBX_page_void)
+ return MDBX_SUCCESS;
+
+ walk_dbi_t *dbi = pagemap_lookup_dbi(dbi_name_or_tag, false);
+ if (!dbi)
+ return MDBX_ENOMEM;
+
+ const size_t page_bytes = payload_bytes + header_bytes + unused_bytes;
+ walk.pgcount += pgnumber;
+
+ const char *pagetype_caption;
+ bool branch = false;
+ switch (pagetype) {
+ default:
+ problem_add("page", pgno, "unknown page-type", "type %u, deep %i",
+ (unsigned)pagetype, deep);
+ pagetype_caption = "unknown";
+ dbi->pages.other += pgnumber;
+ break;
+ case MDBX_page_meta:
+ pagetype_caption = "meta";
+ dbi->pages.other += pgnumber;
+ break;
+ case MDBX_page_large:
+ pagetype_caption = "large";
+ dbi->pages.large_volume += pgnumber;
+ dbi->pages.large_count += 1;
+ break;
+ case MDBX_page_branch:
+ pagetype_caption = "branch";
+ dbi->pages.branch += pgnumber;
+ branch = true;
+ break;
+ case MDBX_page_leaf:
+ pagetype_caption = "leaf";
+ dbi->pages.leaf += pgnumber;
+ break;
+ case MDBX_page_dupfixed_leaf:
+ pagetype_caption = "leaf-dupfixed";
+ dbi->pages.leaf_dupfixed += pgnumber;
+ break;
+ case MDBX_subpage_leaf:
+ pagetype_caption = "subleaf-dupsort";
+ dbi->pages.subleaf_dupsort += 1;
+ break;
+ case MDBX_subpage_dupfixed_leaf:
+ pagetype_caption = "subleaf-dupfixed";
+ dbi->pages.subleaf_dupfixed += 1;
+ break;
+ }
+
+ if (pgnumber) {
+ if (verbose > 3 && (!only_subdb || strcmp(only_subdb, dbi->name) == 0)) {
+ if (pgnumber == 1)
+ print(" %s-page %" PRIu64, pagetype_caption, pgno);
+ else
+ print(" %s-span %" PRIu64 "[%u]", pagetype_caption, pgno, pgnumber);
+ print(" of %s: header %" PRIiPTR ", payload %" PRIiPTR
+ ", unused %" PRIiPTR ", deep %i\n",
+ dbi->name, header_bytes, payload_bytes, unused_bytes, deep);
+ }
+
+ bool already_used = false;
+ for (unsigned n = 0; n < pgnumber; ++n) {
+ uint64_t spanpgno = pgno + n;
+ if (spanpgno >= alloc_pages)
+ problem_add("page", spanpgno, "wrong page-no",
+ "%s-page: %" PRIu64 " > %" PRIu64 ", deep %i",
+ pagetype_caption, spanpgno, alloc_pages, deep);
+ else if (walk.pagemap[spanpgno]) {
+ walk_dbi_t *coll_dbi = &walk.dbi[walk.pagemap[spanpgno] - 1];
+ problem_add("page", spanpgno,
+ (branch && coll_dbi == dbi) ? "loop" : "already used",
+ "%s-page: by %s, deep %i", pagetype_caption, coll_dbi->name,
+ deep);
+ already_used = true;
+ } else {
+ walk.pagemap[spanpgno] = (short)(dbi - walk.dbi + 1);
+ dbi->pages.total += 1;
+ }
+ }
+
+ if (already_used)
+ return branch ? MDBX_RESULT_TRUE /* avoid infinite loop/recursion */
+ : MDBX_SUCCESS;
+ }
+
+ if (unused_bytes > page_size)
+ problem_add("page", pgno, "illegal unused-bytes",
+ "%s-page: %u < %" PRIuPTR " < %u", pagetype_caption, 0,
+ unused_bytes, envstat.ms_psize);
+
+ if (header_bytes < (int)sizeof(long) ||
+ (size_t)header_bytes >= envstat.ms_psize - sizeof(long))
+ problem_add("page", pgno, "illegal header-length",
+ "%s-page: %" PRIuPTR " < %" PRIuPTR " < %" PRIuPTR,
+ pagetype_caption, sizeof(long), header_bytes,
+ envstat.ms_psize - sizeof(long));
+ if (payload_bytes < 1) {
+ if (nentries > 1) {
+ problem_add("page", pgno, "zero size-of-entry",
+ "%s-page: payload %" PRIuPTR " bytes, %" PRIuPTR " entries",
+ pagetype_caption, payload_bytes, nentries);
+ /* if ((size_t)header_bytes + unused_bytes < page_size) {
+ // LY: hush a misuse error
+ page_bytes = page_size;
+ } */
+ } else {
+ problem_add("page", pgno, "empty",
+ "%s-page: payload %" PRIuPTR " bytes, %" PRIuPTR
+ " entries, deep %i",
+ pagetype_caption, payload_bytes, nentries, deep);
+ dbi->pages.empty += 1;
+ }
+ }
+
+ if (pgnumber) {
+ if (page_bytes != page_size) {
+ problem_add("page", pgno, "misused",
+ "%s-page: %" PRIuPTR " != %" PRIuPTR " (%" PRIuPTR
+ "h + %" PRIuPTR "p + %" PRIuPTR "u), deep %i",
+ pagetype_caption, page_size, page_bytes, header_bytes,
+ payload_bytes, unused_bytes, deep);
+ if (page_size > page_bytes)
+ dbi->lost_bytes += page_size - page_bytes;
+ } else {
+ dbi->payload_bytes += payload_bytes + header_bytes;
+ walk.total_payload_bytes += payload_bytes + header_bytes;
+ }
+ }
+
+ return user_break ? MDBX_EINTR : MDBX_SUCCESS;
+}
+
+typedef int(visitor)(const uint64_t record_number, const MDBX_val *key,
+ const MDBX_val *data);
+static int process_db(MDBX_dbi dbi_handle, char *dbi_name, visitor *handler,
+ bool silent);
+
+static int handle_userdb(const uint64_t record_number, const MDBX_val *key,
+ const MDBX_val *data) {
+ (void)record_number;
+ (void)key;
+ (void)data;
+ return MDBX_SUCCESS;
+}
+
+static int handle_freedb(const uint64_t record_number, const MDBX_val *key,
+ const MDBX_val *data) {
+ char *bad = "";
+ pgno_t *iptr = data->iov_base;
+
+ if (key->iov_len != sizeof(txnid_t))
+ problem_add("entry", record_number, "wrong txn-id size",
+ "key-size %" PRIiPTR, key->iov_len);
+ else {
+ txnid_t txnid;
+ memcpy(&txnid, key->iov_base, sizeof(txnid));
+ if (txnid < 1 || txnid > envinfo.mi_recent_txnid)
+ problem_add("entry", record_number, "wrong txn-id", "%" PRIaTXN, txnid);
+ else {
+ if (data->iov_len < sizeof(pgno_t) || data->iov_len % sizeof(pgno_t))
+ problem_add("entry", txnid, "wrong idl size", "%" PRIuPTR,
+ data->iov_len);
+ size_t number = (data->iov_len >= sizeof(pgno_t)) ? *iptr++ : 0;
+ if (number < 1 || number > MDBX_PNL_MAX)
+ problem_add("entry", txnid, "wrong idl length", "%" PRIuPTR, number);
+ else if ((number + 1) * sizeof(pgno_t) > data->iov_len) {
+ problem_add("entry", txnid, "trimmed idl",
+ "%" PRIuSIZE " > %" PRIuSIZE " (corruption)",
+ (number + 1) * sizeof(pgno_t), data->iov_len);
+ number = data->iov_len / sizeof(pgno_t) - 1;
+ } else if (data->iov_len - (number + 1) * sizeof(pgno_t) >=
+ /* LY: allow gap upto one page. it is ok
+ * and better than shink-and-retry inside mdbx_update_gc() */
+ envstat.ms_psize)
+ problem_add("entry", txnid, "extra idl space",
+ "%" PRIuSIZE " < %" PRIuSIZE " (minor, not a trouble)",
+ (number + 1) * sizeof(pgno_t), data->iov_len);
+
+ gc_pages += number;
+ if (envinfo.mi_latter_reader_txnid > txnid)
+ reclaimable_pages += number;
+
+ pgno_t prev = MDBX_PNL_ASCENDING ? NUM_METAS - 1 : txn->mt_next_pgno;
+ pgno_t span = 1;
+ for (unsigned i = 0; i < number; ++i) {
+ const pgno_t pgno = iptr[i];
+ if (pgno < NUM_METAS)
+ problem_add("entry", txnid, "wrong idl entry",
+ "pgno %" PRIaPGNO " < meta-pages %u", pgno, NUM_METAS);
+ else if (pgno >= backed_pages)
+ problem_add("entry", txnid, "wrong idl entry",
+ "pgno %" PRIaPGNO " > backed-pages %" PRIu64, pgno,
+ backed_pages);
+ else if (pgno >= alloc_pages)
+ problem_add("entry", txnid, "wrong idl entry",
+ "pgno %" PRIaPGNO " > alloc-pages %" PRIu64, pgno,
+ alloc_pages - 1);
+ else {
+ if (MDBX_PNL_DISORDERED(prev, pgno)) {
+ bad = " [bad sequence]";
+ problem_add("entry", txnid, "bad sequence",
+ "%" PRIaPGNO " %c [%u].%" PRIaPGNO, prev,
+ (prev == pgno) ? '=' : (MDBX_PNL_ASCENDING ? '>' : '<'),
+ i, pgno);
+ }
+ if (walk.pagemap) {
+ int idx = walk.pagemap[pgno];
+ if (idx == 0)
+ walk.pagemap[pgno] = -1;
+ else if (idx > 0)
+ problem_add("page", pgno, "already used", "by %s",
+ walk.dbi[idx - 1].name);
+ else
+ problem_add("page", pgno, "already listed in GC", nullptr);
+ }
+ }
+ prev = pgno;
+ while (i + span < number &&
+ iptr[i + span] == (MDBX_PNL_ASCENDING ? pgno_add(pgno, span)
+ : pgno_sub(pgno, span)))
+ ++span;
+ }
+ if (verbose > 3 && !only_subdb) {
+ print(" transaction %" PRIaTXN ", %" PRIuPTR
+ " pages, maxspan %" PRIaPGNO "%s\n",
+ txnid, number, span, bad);
+ if (verbose > 4) {
+ for (unsigned i = 0; i < number; i += span) {
+ const pgno_t pgno = iptr[i];
+ for (span = 1;
+ i + span < number &&
+ iptr[i + span] == (MDBX_PNL_ASCENDING ? pgno_add(pgno, span)
+ : pgno_sub(pgno, span));
+ ++span)
+ ;
+ if (span > 1) {
+ print(" %9" PRIaPGNO "[%" PRIaPGNO "]\n", pgno, span);
+ } else
+ print(" %9" PRIaPGNO "\n", pgno);
+ }
+ }
+ }
+ }
+ }
+
+ return MDBX_SUCCESS;
+}
+
+static int handle_maindb(const uint64_t record_number, const MDBX_val *key,
+ const MDBX_val *data) {
+ char *name;
+ int rc;
+ size_t i;
+
+ name = key->iov_base;
+ for (i = 0; i < key->iov_len; ++i) {
+ if (name[i] < ' ')
+ return handle_userdb(record_number, key, data);
+ }
+
+ name = mdbx_malloc(key->iov_len + 1);
+ memcpy(name, key->iov_base, key->iov_len);
+ name[key->iov_len] = '\0';
+ userdb_count++;
+
+ rc = process_db(~0u, name, handle_userdb, false);
+ mdbx_free(name);
+ if (rc != MDBX_INCOMPATIBLE)
+ return rc;
+
+ return handle_userdb(record_number, key, data);
+}
+
+static int process_db(MDBX_dbi dbi_handle, char *dbi_name, visitor *handler,
+ bool silent) {
+ MDBX_cursor *mc;
+ MDBX_stat ms;
+ MDBX_val key, data;
+ MDBX_val prev_key, prev_data;
+ unsigned flags;
+ int rc, i;
+ struct problem *saved_list;
+ uint64_t problems_count;
+
+ uint64_t record_count = 0, dups = 0;
+ uint64_t key_bytes = 0, data_bytes = 0;
+
+ if (dbi_handle == ~0u) {
+ rc = mdbx_dbi_open(txn, dbi_name, 0, &dbi_handle);
+ if (rc) {
+ if (!dbi_name ||
+ rc !=
+ MDBX_INCOMPATIBLE) /* LY: mainDB's record is not a user's DB. */ {
+ error("mdbx_open '%s' failed, error %d %s\n",
+ dbi_name ? dbi_name : "main", rc, mdbx_strerror(rc));
+ }
+ return rc;
+ }
+ }
+
+ if (dbi_handle >= CORE_DBS && dbi_name && only_subdb &&
+ strcmp(only_subdb, dbi_name) != 0) {
+ if (verbose) {
+ print("Skip processing '%s'...\n", dbi_name);
+ fflush(NULL);
+ }
+ skipped_subdb++;
+ return MDBX_SUCCESS;
+ }
+
+ if (!silent && verbose) {
+ print("Processing '%s'...\n", dbi_name ? dbi_name : "@MAIN");
+ fflush(NULL);
+ }
+
+ rc = mdbx_dbi_flags(txn, dbi_handle, &flags);
+ if (rc) {
+ error("mdbx_dbi_flags failed, error %d %s\n", rc, mdbx_strerror(rc));
+ return rc;
+ }
+
+ rc = mdbx_dbi_stat(txn, dbi_handle, &ms, sizeof(ms));
+ if (rc) {
+ error("mdbx_dbi_stat failed, error %d %s\n", rc, mdbx_strerror(rc));
+ return rc;
+ }
+
+ if (!silent && verbose) {
+ print(" - dbi-id %d, flags:", dbi_handle);
+ if (!flags)
+ print(" none");
+ else {
+ for (i = 0; dbflags[i].bit; i++)
+ if (flags & dbflags[i].bit)
+ print(" %s", dbflags[i].name);
+ }
+ print(" (0x%02X)\n", flags);
+ if (verbose > 1) {
+ print(" - page size %u, entries %" PRIu64 "\n", ms.ms_psize,
+ ms.ms_entries);
+ print(" - b-tree depth %u, pages: branch %" PRIu64 ", leaf %" PRIu64
+ ", overflow %" PRIu64 "\n",
+ ms.ms_depth, ms.ms_branch_pages, ms.ms_leaf_pages,
+ ms.ms_overflow_pages);
+ }
+ }
+
+ walk_dbi_t *dbi = (dbi_handle < CORE_DBS)
+ ? &walk.dbi[dbi_handle]
+ : pagemap_lookup_dbi(dbi_name, true);
+ if (!dbi) {
+ error("too many DBIs or out of memory\n");
+ return MDBX_ENOMEM;
+ }
+ const uint64_t subtotal_pages =
+ ms.ms_branch_pages + ms.ms_leaf_pages + ms.ms_overflow_pages;
+ if (subtotal_pages != dbi->pages.total)
+ error("%s pages mismatch (%" PRIu64 " != walked %" PRIu64 ")\n", "subtotal",
+ subtotal_pages, dbi->pages.total);
+ if (ms.ms_branch_pages != dbi->pages.branch)
+ error("%s pages mismatch (%" PRIu64 " != walked %" PRIu64 ")\n", "branch",
+ ms.ms_branch_pages, dbi->pages.branch);
+ const uint64_t allleaf_pages = dbi->pages.leaf + dbi->pages.leaf_dupfixed;
+ if (ms.ms_leaf_pages != allleaf_pages)
+ error("%s pages mismatch (%" PRIu64 " != walked %" PRIu64 ")\n", "all-leaf",
+ ms.ms_leaf_pages, allleaf_pages);
+ if (ms.ms_overflow_pages != dbi->pages.large_volume)
+ error("%s pages mismatch (%" PRIu64 " != walked %" PRIu64 ")\n",
+ "large/overlow", ms.ms_overflow_pages, dbi->pages.large_volume);
+
+ rc = mdbx_cursor_open(txn, dbi_handle, &mc);
+ if (rc) {
+ error("mdbx_cursor_open failed, error %d %s\n", rc, mdbx_strerror(rc));
+ return rc;
+ }
+
+ saved_list = problems_push();
+ prev_key.iov_base = NULL;
+ prev_key.iov_len = 0;
+ prev_data.iov_base = NULL;
+ prev_data.iov_len = 0;
+ rc = mdbx_cursor_get(mc, &key, &data, MDBX_FIRST);
+ while (rc == MDBX_SUCCESS) {
+ if (user_break) {
+ print(" - interrupted by signal\n");
+ fflush(NULL);
+ rc = MDBX_EINTR;
+ goto bailout;
+ }
+
+ bool bad_key = false;
+ if (key.iov_len > maxkeysize) {
+ problem_add("entry", record_count, "key length exceeds max-key-size",
+ "%" PRIuPTR " > %" PRIuPTR, key.iov_len, maxkeysize);
+ bad_key = true;
+ } else if ((flags & MDBX_INTEGERKEY) && key.iov_len != sizeof(uint64_t) &&
+ key.iov_len != sizeof(uint32_t)) {
+ problem_add("entry", record_count, "wrong key length",
+ "%" PRIuPTR " != 4or8", key.iov_len);
+ bad_key = true;
+ }
+
+ bool bad_data = false;
+ if ((flags & MDBX_INTEGERDUP) && data.iov_len != sizeof(uint64_t) &&
+ data.iov_len != sizeof(uint32_t)) {
+ problem_add("entry", record_count, "wrong data length",
+ "%" PRIuPTR " != 4or8", data.iov_len);
+ bad_data = true;
+ }
+
+ if (prev_key.iov_base && !bad_data) {
+ if ((flags & MDBX_DUPFIXED) && prev_data.iov_len != data.iov_len) {
+ problem_add("entry", record_count, "different data length",
+ "%" PRIuPTR " != %" PRIuPTR, prev_data.iov_len,
+ data.iov_len);
+ bad_data = true;
+ }
+
+ if (!bad_key) {
+ int cmp = mdbx_cmp(txn, dbi_handle, &prev_key, &key);
+ if (cmp == 0) {
+ ++dups;
+ if ((flags & MDBX_DUPSORT) == 0) {
+ problem_add("entry", record_count, "duplicated entries", NULL);
+ if (data.iov_len == prev_data.iov_len &&
+ memcmp(data.iov_base, prev_data.iov_base, data.iov_len) == 0) {
+ problem_add("entry", record_count, "complete duplicate", NULL);
+ }
+ } else if (!bad_data) {
+ cmp = mdbx_dcmp(txn, dbi_handle, &prev_data, &data);
+ if (cmp == 0) {
+ problem_add("entry", record_count, "complete duplicate", NULL);
+ } else if (cmp > 0 && !ignore_wrong_order) {
+ problem_add("entry", record_count, "wrong order of multi-values",
+ NULL);
+ }
+ }
+ } else if (cmp > 0 && !ignore_wrong_order) {
+ problem_add("entry", record_count, "wrong order of entries", NULL);
+ }
+ }
+ } else if (verbose) {
+ if (flags & MDBX_INTEGERKEY)
+ print(" - fixed key-size %" PRIuPTR "\n", key.iov_len);
+ if (flags & (MDBX_INTEGERDUP | MDBX_DUPFIXED))
+ print(" - fixed data-size %" PRIuPTR "\n", data.iov_len);
+ }
+
+ if (handler) {
+ rc = handler(record_count, &key, &data);
+ if (MDBX_IS_ERROR(rc))
+ goto bailout;
+ }
+
+ record_count++;
+ key_bytes += key.iov_len;
+ data_bytes += data.iov_len;
+
+ if (!bad_key)
+ prev_key = key;
+ if (!bad_data)
+ prev_data = data;
+ rc = mdbx_cursor_get(mc, &key, &data, MDBX_NEXT);
+ }
+ if (rc != MDBX_NOTFOUND)
+ error("mdbx_cursor_get failed, error %d %s\n", rc, mdbx_strerror(rc));
+ else
+ rc = 0;
+
+ if (record_count != ms.ms_entries)
+ problem_add("entry", record_count, "differentent number of entries",
+ "%" PRIu64 " != %" PRIu64, record_count, ms.ms_entries);
+bailout:
+ problems_count = problems_pop(saved_list);
+ if (!silent && verbose) {
+ print(" - summary: %" PRIu64 " records, %" PRIu64 " dups, %" PRIu64
+ " key's bytes, %" PRIu64 " data's "
+ "bytes, %" PRIu64 " problems\n",
+ record_count, dups, key_bytes, data_bytes, problems_count);
+ fflush(NULL);
+ }
+
+ mdbx_cursor_close(mc);
+ return (rc || problems_count) ? MDBX_RESULT_TRUE : MDBX_SUCCESS;
+}
+
+static void usage(char *prog) {
+ fprintf(stderr,
+ "usage: %s dbpath [-V] [-v] [-n] [-q] [-w] [-c] [-d] [-s subdb]\n"
+ " -V\t\tshow version\n"
+ " -v\t\tmore verbose, could be used multiple times\n"
+ " -n\t\tNOSUBDIR mode for open\n"
+ " -q\t\tbe quiet\n"
+ " -w\t\tlock DB for writing while checking\n"
+ " -d\t\tdisable page-by-page traversal of B-tree\n"
+ " -s subdb\tprocess a specific subdatabase only\n"
+ " -c\t\tforce cooperative mode (don't try exclusive)\n"
+ " -i\t\tignore wrong order errors (for custom comparators case)\n",
+ prog);
+ exit(EXIT_INTERRUPTED);
+}
+
+const char *meta_synctype(uint64_t sign) {
+ switch (sign) {
+ case MDBX_DATASIGN_NONE:
+ return "no-sync/legacy";
+ case MDBX_DATASIGN_WEAK:
+ return "weak";
+ default:
+ return "steady";
+ }
+}
+
+static __inline bool meta_ot(txnid_t txn_a, uint64_t sign_a, txnid_t txn_b,
+ uint64_t sign_b, const bool roolback2steady) {
+ if (txn_a == txn_b)
+ return SIGN_IS_STEADY(sign_b);
+
+ if (roolback2steady && SIGN_IS_STEADY(sign_a) != SIGN_IS_STEADY(sign_b))
+ return SIGN_IS_STEADY(sign_b);
+
+ return txn_a < txn_b;
+}
+
+static __inline bool meta_eq(txnid_t txn_a, uint64_t sign_a, txnid_t txn_b,
+ uint64_t sign_b) {
+ if (txn_a != txn_b)
+ return false;
+
+ if (SIGN_IS_STEADY(sign_a) != SIGN_IS_STEADY(sign_b))
+ return false;
+
+ return true;
+}
+
+static __inline int meta_recent(const bool roolback2steady) {
+
+ if (meta_ot(envinfo.mi_meta0_txnid, envinfo.mi_meta0_sign,
+ envinfo.mi_meta1_txnid, envinfo.mi_meta1_sign, roolback2steady))
+ return meta_ot(envinfo.mi_meta2_txnid, envinfo.mi_meta2_sign,
+ envinfo.mi_meta1_txnid, envinfo.mi_meta1_sign,
+ roolback2steady)
+ ? 1
+ : 2;
+
+ return meta_ot(envinfo.mi_meta0_txnid, envinfo.mi_meta0_sign,
+ envinfo.mi_meta2_txnid, envinfo.mi_meta2_sign, roolback2steady)
+ ? 2
+ : 0;
+}
+
+static __inline int meta_tail(int head) {
+
+ if (head == 0)
+ return meta_ot(envinfo.mi_meta1_txnid, envinfo.mi_meta1_sign,
+ envinfo.mi_meta2_txnid, envinfo.mi_meta2_sign, true)
+ ? 1
+ : 2;
+ if (head == 1)
+ return meta_ot(envinfo.mi_meta0_txnid, envinfo.mi_meta0_sign,
+ envinfo.mi_meta2_txnid, envinfo.mi_meta2_sign, true)
+ ? 0
+ : 2;
+ if (head == 2)
+ return meta_ot(envinfo.mi_meta0_txnid, envinfo.mi_meta0_sign,
+ envinfo.mi_meta1_txnid, envinfo.mi_meta1_sign, true)
+ ? 0
+ : 1;
+ assert(false);
+ return -1;
+}
+
+static int meta_steady(void) { return meta_recent(true); }
+
+static int meta_head(void) { return meta_recent(false); }
+
+void verbose_meta(int num, txnid_t txnid, uint64_t sign) {
+ print(" - meta-%d: %s %" PRIu64, num, meta_synctype(sign), txnid);
+ bool stay = true;
+
+ const int steady = meta_steady();
+ const int head = meta_head();
+ if (num == steady && num == head) {
+ print(", head");
+ stay = false;
+ } else if (num == steady) {
+ print(", head-steady");
+ stay = false;
+ } else if (num == head) {
+ print(", head-weak");
+ stay = false;
+ }
+ if (num == meta_tail(head)) {
+ print(", tail");
+ stay = false;
+ }
+ if (stay)
+ print(", stay");
+
+ if (txnid > envinfo.mi_recent_txnid &&
+ (envflags & (MDBX_EXCLUSIVE | MDBX_RDONLY)) == MDBX_EXCLUSIVE)
+ print(", rolled-back %" PRIu64 " (%" PRIu64 " >>> %" PRIu64 ")",
+ txnid - envinfo.mi_recent_txnid, txnid, envinfo.mi_recent_txnid);
+ print("\n");
+}
+
+static int check_meta_head(bool steady) {
+ switch (meta_recent(steady)) {
+ default:
+ assert(false);
+ error("unexpected internal error (%s)\n",
+ steady ? "meta_steady_head" : "meta_weak_head");
+ __fallthrough;
+ case 0:
+ if (envinfo.mi_meta0_txnid != envinfo.mi_recent_txnid) {
+ print(" - meta-%d txn-id mismatch recent-txn-id (%" PRIi64 " != %" PRIi64
+ ")\n",
+ 0, envinfo.mi_meta0_txnid, envinfo.mi_recent_txnid);
+ return 1;
+ }
+ break;
+ case 1:
+ if (envinfo.mi_meta1_txnid != envinfo.mi_recent_txnid) {
+ print(" - meta-%d txn-id mismatch recent-txn-id (%" PRIi64 " != %" PRIi64
+ ")\n",
+ 1, envinfo.mi_meta1_txnid, envinfo.mi_recent_txnid);
+ return 1;
+ }
+ break;
+ case 2:
+ if (envinfo.mi_meta2_txnid != envinfo.mi_recent_txnid) {
+ print(" - meta-%d txn-id mismatch recent-txn-id (%" PRIi64 " != %" PRIi64
+ ")\n",
+ 2, envinfo.mi_meta2_txnid, envinfo.mi_recent_txnid);
+ return 1;
+ }
+ }
+ return 0;
+}
+
+static void print_size(const char *prefix, const uint64_t value,
+ const char *suffix) {
+ const char sf[] =
+ "KMGTPEZY"; /* LY: Kilo, Mega, Giga, Tera, Peta, Exa, Zetta, Yotta! */
+ double k = 1024.0;
+ size_t i;
+ for (i = 0; sf[i + 1] && value / k > 1000.0; ++i)
+ k *= 1024;
+ print("%s%" PRIu64 " (%.2f %cb)%s", prefix, value, value / k, sf[i], suffix);
+}
+
+int main(int argc, char *argv[]) {
+ int rc;
+ char *prog = argv[0];
+ char *envname;
+ int problems_maindb = 0, problems_freedb = 0, problems_meta = 0;
+ bool dont_traversal = false;
+ bool locked = false;
+
+ double elapsed;
+#if defined(_WIN32) || defined(_WIN64)
+ uint64_t timestamp_start, timestamp_finish;
+ timestamp_start = GetTickCount64();
+#else
+ struct timespec timestamp_start, timestamp_finish;
+ if (clock_gettime(CLOCK_MONOTONIC, ×tamp_start)) {
+ rc = errno;
+ error("clock_gettime failed, error %d %s\n", rc, mdbx_strerror(rc));
+ return EXIT_FAILURE_SYS;
+ }
+#endif
+
+ dbi_meta.name = "@META";
+ dbi_free.name = "@GC";
+ dbi_main.name = "@MAIN";
+ atexit(pagemap_cleanup);
+
+ if (argc < 2)
+ usage(prog);
+
+ for (int i; (i = getopt(argc, argv, "Vvqnwcdsi:")) != EOF;) {
+ switch (i) {
+ case 'V':
+ printf("mdbx_chk version %d.%d.%d.%d\n"
+ " - source: %s %s, commit %s, tree %s\n"
+ " - anchor: %s\n"
+ " - build: %s for %s by %s\n"
+ " - flags: %s\n"
+ " - options: %s\n",
+ mdbx_version.major, mdbx_version.minor, mdbx_version.release,
+ mdbx_version.revision, mdbx_version.git.describe,
+ mdbx_version.git.datetime, mdbx_version.git.commit,
+ mdbx_version.git.tree, mdbx_sourcery_anchor, mdbx_build.datetime,
+ mdbx_build.target, mdbx_build.compiler, mdbx_build.flags,
+ mdbx_build.options);
+ return EXIT_SUCCESS;
+ case 'v':
+ verbose++;
+ break;
+ case 'q':
+ quiet = true;
+ break;
+ case 'n':
+ envflags |= MDBX_NOSUBDIR;
+ break;
+ case 'w':
+ envflags &= ~MDBX_RDONLY;
+ break;
+ case 'c':
+ envflags &= ~MDBX_EXCLUSIVE;
+ break;
+ case 'd':
+ dont_traversal = true;
+ break;
+ case 's':
+ if (only_subdb && strcmp(only_subdb, optarg))
+ usage(prog);
+ only_subdb = optarg;
+ break;
+ case 'i':
+ ignore_wrong_order = true;
+ break;
+ default:
+ usage(prog);
+ }
+ }
+
+ if (optind != argc - 1)
+ usage(prog);
+
+#if defined(_WIN32) || defined(_WIN64)
+ SetConsoleCtrlHandler(ConsoleBreakHandlerRoutine, true);
+#else
+#ifdef SIGPIPE
+ signal(SIGPIPE, signal_handler);
+#endif
+#ifdef SIGHUP
+ signal(SIGHUP, signal_handler);
+#endif
+ signal(SIGINT, signal_handler);
+ signal(SIGTERM, signal_handler);
+#endif /* !WINDOWS */
+
+ envname = argv[optind];
+ print("mdbx_chk %s (%s, T-%s)\nRunning for %s in 'read-%s' mode...\n",
+ mdbx_version.git.describe, mdbx_version.git.datetime,
+ mdbx_version.git.tree, envname,
+ (envflags & MDBX_RDONLY) ? "only" : "write");
+ fflush(NULL);
+
+ rc = mdbx_env_create(&env);
+ if (rc) {
+ error("mdbx_env_create failed, error %d %s\n", rc, mdbx_strerror(rc));
+ return rc < 0 ? EXIT_FAILURE_MDB : EXIT_FAILURE_SYS;
+ }
+
+ rc = mdbx_env_set_maxdbs(env, MAX_DBI);
+ if (rc) {
+ error("mdbx_env_set_maxdbs failed, error %d %s\n", rc, mdbx_strerror(rc));
+ goto bailout;
+ }
+
+ rc = mdbx_env_open(env, envname, envflags, 0664);
+ if ((envflags & MDBX_EXCLUSIVE) &&
+ (rc == MDBX_BUSY ||
+#if defined(_WIN32) || defined(_WIN64)
+ rc == ERROR_LOCK_VIOLATION || rc == ERROR_SHARING_VIOLATION
+#else
+ rc == EBUSY || rc == EAGAIN
+#endif
+ )) {
+ envflags &= ~MDBX_EXCLUSIVE;
+ rc = mdbx_env_open(env, envname, envflags, 0664);
+ }
+
+ if (rc) {
+ error("mdbx_env_open failed, error %d %s\n", rc, mdbx_strerror(rc));
+ if (rc == MDBX_WANNA_RECOVERY && (envflags & MDBX_RDONLY))
+ print("Please run %s in the read-write mode (with '-w' option).\n", prog);
+ goto bailout;
+ }
+ if (verbose)
+ print(" - %s mode\n",
+ (envflags & MDBX_EXCLUSIVE) ? "monopolistic" : "cooperative");
+
+ if ((envflags & MDBX_RDONLY) == 0) {
+ rc = mdbx_txn_lock(env, false);
+ if (rc != MDBX_SUCCESS) {
+ error("mdbx_txn_lock failed, error %d %s\n", rc, mdbx_strerror(rc));
+ goto bailout;
+ }
+ locked = true;
+ }
+
+ rc = mdbx_txn_begin(env, NULL, MDBX_RDONLY, &txn);
+ if (rc) {
+ error("mdbx_txn_begin() failed, error %d %s\n", rc, mdbx_strerror(rc));
+ goto bailout;
+ }
+
+ rc = mdbx_env_get_maxkeysize(env);
+ if (rc < 0) {
+ error("mdbx_env_get_maxkeysize failed, error %d %s\n", rc,
+ mdbx_strerror(rc));
+ goto bailout;
+ }
+ maxkeysize = rc;
+
+ rc = mdbx_env_info_ex(env, txn, &envinfo, sizeof(envinfo));
+ if (rc) {
+ error("mdbx_env_info failed, error %d %s\n", rc, mdbx_strerror(rc));
+ goto bailout;
+ }
+
+ rc = mdbx_env_stat_ex(env, txn, &envstat, sizeof(envstat));
+ if (rc) {
+ error("mdbx_env_stat failed, error %d %s\n", rc, mdbx_strerror(rc));
+ goto bailout;
+ }
+
+ mdbx_filehandle_t dxb_fd;
+ rc = mdbx_env_get_fd(env, &dxb_fd);
+ if (rc) {
+ error("mdbx_env_get_fd failed, error %d %s\n", rc, mdbx_strerror(rc));
+ goto bailout;
+ }
+
+ uint64_t dxb_filesize = 0;
+#if defined(_WIN32) || defined(_WIN64)
+ {
+ BY_HANDLE_FILE_INFORMATION info;
+ if (!GetFileInformationByHandle(dxb_fd, &info))
+ rc = GetLastError();
+ else
+ dxb_filesize = info.nFileSizeLow | (uint64_t)info.nFileSizeHigh << 32;
+ }
+#else
+ {
+ struct stat st;
+ STATIC_ASSERT_MSG(sizeof(off_t) <= sizeof(uint64_t),
+ "libmdbx requires 64-bit file I/O on 64-bit systems");
+ if (fstat(dxb_fd, &st))
+ rc = errno;
+ else
+ dxb_filesize = st.st_size;
+ }
+#endif
+ if (rc) {
+ error("mdbx_filesize failed, error %d %s\n", rc, mdbx_strerror(rc));
+ goto bailout;
+ }
+
+ errno = 0;
+ const uint64_t dxbfile_pages = dxb_filesize / envinfo.mi_dxb_pagesize;
+ alloc_pages = txn->mt_next_pgno;
+ backed_pages = envinfo.mi_geo.current / envinfo.mi_dxb_pagesize;
+ if (backed_pages > dxbfile_pages) {
+ print(" ! backed-pages %" PRIu64 " > file-pages %" PRIu64 "\n",
+ backed_pages, dxbfile_pages);
+ ++problems_meta;
+ }
+ if (dxbfile_pages < NUM_METAS)
+ print(" ! file-pages %" PRIu64 " < %u\n", dxbfile_pages, NUM_METAS);
+ if (backed_pages < NUM_METAS)
+ print(" ! backed-pages %" PRIu64 " < %u\n", backed_pages, NUM_METAS);
+ if (backed_pages < NUM_METAS || dxbfile_pages < NUM_METAS)
+ goto bailout;
+ if (backed_pages > MAX_PAGENO) {
+ print(" ! backed-pages %" PRIu64 " > max-pages %" PRIaPGNO "\n",
+ backed_pages, MAX_PAGENO);
+ ++problems_meta;
+ backed_pages = MAX_PAGENO;
+ }
+
+ if ((envflags & (MDBX_EXCLUSIVE | MDBX_RDONLY)) != MDBX_RDONLY) {
+ if (backed_pages > dxbfile_pages) {
+ print(" ! backed-pages %" PRIu64 " > file-pages %" PRIu64 "\n",
+ backed_pages, dxbfile_pages);
+ ++problems_meta;
+ backed_pages = dxbfile_pages;
+ }
+ if (alloc_pages > backed_pages) {
+ print(" ! alloc-pages %" PRIu64 " > backed-pages %" PRIu64 "\n",
+ alloc_pages, backed_pages);
+ ++problems_meta;
+ alloc_pages = backed_pages;
+ }
+ } else {
+ /* LY: DB may be shrinked by writer downto the allocated pages. */
+ if (alloc_pages > backed_pages) {
+ print(" ! alloc-pages %" PRIu64 " > backed-pages %" PRIu64 "\n",
+ alloc_pages, backed_pages);
+ ++problems_meta;
+ alloc_pages = backed_pages;
+ }
+ if (alloc_pages > dxbfile_pages) {
+ print(" ! alloc-pages %" PRIu64 " > file-pages %" PRIu64 "\n",
+ alloc_pages, dxbfile_pages);
+ ++problems_meta;
+ alloc_pages = dxbfile_pages;
+ }
+ if (backed_pages > dxbfile_pages)
+ backed_pages = dxbfile_pages;
+ }
+
+ if (verbose) {
+ print(" - pagesize %u (%u system), max keysize %" PRIuPTR
+ ", max readers %u\n",
+ envinfo.mi_dxb_pagesize, envinfo.mi_sys_pagesize, maxkeysize,
+ envinfo.mi_maxreaders);
+ print_size(" - mapsize ", envinfo.mi_mapsize, "\n");
+ if (envinfo.mi_geo.lower == envinfo.mi_geo.upper)
+ print_size(" - fixed datafile: ", envinfo.mi_geo.current, "");
+ else {
+ print_size(" - dynamic datafile: ", envinfo.mi_geo.lower, "");
+ print_size(" .. ", envinfo.mi_geo.upper, ", ");
+ print_size("+", envinfo.mi_geo.grow, ", ");
+ print_size("-", envinfo.mi_geo.shrink, "\n");
+ print_size(" - current datafile: ", envinfo.mi_geo.current, "");
+ }
+ printf(", %" PRIu64 " pages\n",
+ envinfo.mi_geo.current / envinfo.mi_dxb_pagesize);
+ print(" - transactions: recent %" PRIu64 ", latter reader %" PRIu64
+ ", lag %" PRIi64 "\n",
+ envinfo.mi_recent_txnid, envinfo.mi_latter_reader_txnid,
+ envinfo.mi_recent_txnid - envinfo.mi_latter_reader_txnid);
+
+ verbose_meta(0, envinfo.mi_meta0_txnid, envinfo.mi_meta0_sign);
+ verbose_meta(1, envinfo.mi_meta1_txnid, envinfo.mi_meta1_sign);
+ verbose_meta(2, envinfo.mi_meta2_txnid, envinfo.mi_meta2_sign);
+ }
+
+ if (verbose)
+ print(" - performs check for meta-pages clashes\n");
+ if (meta_eq(envinfo.mi_meta0_txnid, envinfo.mi_meta0_sign,
+ envinfo.mi_meta1_txnid, envinfo.mi_meta1_sign)) {
+ print(" ! meta-%d and meta-%d are clashed\n", 0, 1);
+ ++problems_meta;
+ }
+ if (meta_eq(envinfo.mi_meta1_txnid, envinfo.mi_meta1_sign,
+ envinfo.mi_meta2_txnid, envinfo.mi_meta2_sign)) {
+ print(" ! meta-%d and meta-%d are clashed\n", 1, 2);
+ ++problems_meta;
+ }
+ if (meta_eq(envinfo.mi_meta2_txnid, envinfo.mi_meta2_sign,
+ envinfo.mi_meta0_txnid, envinfo.mi_meta0_sign)) {
+ print(" ! meta-%d and meta-%d are clashed\n", 2, 0);
+ ++problems_meta;
+ }
+
+ if (envflags & MDBX_EXCLUSIVE) {
+ if (verbose)
+ print(" - performs full check recent-txn-id with meta-pages\n");
+ problems_meta += check_meta_head(true);
+ } else if (locked) {
+ if (verbose)
+ print(" - performs lite check recent-txn-id with meta-pages (not a "
+ "monopolistic mode)\n");
+ problems_meta += check_meta_head(false);
+ } else if (verbose) {
+ print(" - skip check recent-txn-id with meta-pages (monopolistic or "
+ "read-write mode only)\n");
+ }
+
+ if (!dont_traversal) {
+ struct problem *saved_list;
+ size_t traversal_problems;
+ uint64_t empty_pages, lost_bytes;
+
+ print("Traversal b-tree by txn#%" PRIaTXN "...\n", txn->mt_txnid);
+ fflush(NULL);
+ walk.pagemap = mdbx_calloc((size_t)backed_pages, sizeof(*walk.pagemap));
+ if (!walk.pagemap) {
+ rc = errno ? errno : MDBX_ENOMEM;
+ error("calloc failed, error %d %s\n", rc, mdbx_strerror(rc));
+ goto bailout;
+ }
+
+ saved_list = problems_push();
+ rc = mdbx_env_pgwalk(txn, pgvisitor, NULL);
+ traversal_problems = problems_pop(saved_list);
+
+ if (rc) {
+ if (rc == MDBX_EINTR && user_break) {
+ print(" - interrupted by signal\n");
+ fflush(NULL);
+ } else {
+ error("mdbx_env_pgwalk failed, error %d %s\n", rc, mdbx_strerror(rc));
+ }
+ goto bailout;
+ }
+
+ for (uint64_t n = 0; n < alloc_pages; ++n)
+ if (!walk.pagemap[n])
+ unused_pages += 1;
+
+ empty_pages = lost_bytes = 0;
+ for (walk_dbi_t *dbi = &dbi_main; dbi < ARRAY_END(walk.dbi) && dbi->name;
+ ++dbi) {
+ empty_pages += dbi->pages.empty;
+ lost_bytes += dbi->lost_bytes;
+ }
+
+ if (verbose) {
+ uint64_t total_page_bytes = walk.pgcount * envstat.ms_psize;
+ print(" - pages: total %" PRIu64 ", unused %" PRIu64 "\n", walk.pgcount,
+ unused_pages);
+ if (verbose > 1) {
+ for (walk_dbi_t *dbi = walk.dbi; dbi < ARRAY_END(walk.dbi) && dbi->name;
+ ++dbi) {
+ print(" %s: subtotal %" PRIu64, dbi->name, dbi->pages.total);
+ if (dbi->pages.other && dbi->pages.other != dbi->pages.total)
+ print(", other %" PRIu64, dbi->pages.other);
+ if (dbi->pages.branch)
+ print(", branch %" PRIu64, dbi->pages.branch);
+ if (dbi->pages.large_count)
+ print(", large %" PRIu64, dbi->pages.large_count);
+ uint64_t all_leaf = dbi->pages.leaf + dbi->pages.leaf_dupfixed;
+ if (all_leaf) {
+ print(", leaf %" PRIu64, all_leaf);
+ if (verbose > 2 &&
+ (dbi->pages.leaf_dupfixed | dbi->pages.subleaf_dupsort |
+ dbi->pages.subleaf_dupsort))
+ print(" (usual %" PRIu64 ", sub-dupsort %" PRIu64
+ ", dupfixed %" PRIu64 ", sub-dupfixed %" PRIu64 ")",
+ dbi->pages.leaf, dbi->pages.subleaf_dupsort,
+ dbi->pages.leaf_dupfixed, dbi->pages.subleaf_dupfixed);
+ }
+ print("\n");
+ }
+ }
+
+ if (verbose > 1)
+ print(" - usage: total %" PRIu64 " bytes, payload %" PRIu64
+ " (%.1f%%), unused "
+ "%" PRIu64 " (%.1f%%)\n",
+ total_page_bytes, walk.total_payload_bytes,
+ walk.total_payload_bytes * 100.0 / total_page_bytes,
+ total_page_bytes - walk.total_payload_bytes,
+ (total_page_bytes - walk.total_payload_bytes) * 100.0 /
+ total_page_bytes);
+ if (verbose > 2) {
+ for (walk_dbi_t *dbi = walk.dbi; dbi < ARRAY_END(walk.dbi) && dbi->name;
+ ++dbi)
+ if (dbi->pages.total) {
+ uint64_t dbi_bytes = dbi->pages.total * envstat.ms_psize;
+ print(" %s: subtotal %" PRIu64 " bytes (%.1f%%),"
+ " payload %" PRIu64 " (%.1f%%), unused %" PRIu64 " (%.1f%%)",
+ dbi->name, dbi_bytes, dbi_bytes * 100.0 / total_page_bytes,
+ dbi->payload_bytes, dbi->payload_bytes * 100.0 / dbi_bytes,
+ dbi_bytes - dbi->payload_bytes,
+ (dbi_bytes - dbi->payload_bytes) * 100.0 / dbi_bytes);
+ if (dbi->pages.empty)
+ print(", %" PRIu64 " empty pages", dbi->pages.empty);
+ if (dbi->lost_bytes)
+ print(", %" PRIu64 " bytes lost", dbi->lost_bytes);
+ print("\n");
+ } else
+ print(" %s: empty\n", dbi->name);
+ }
+ print(" - summary: average fill %.1f%%",
+ walk.total_payload_bytes * 100.0 / total_page_bytes);
+ if (empty_pages)
+ print(", %" PRIu64 " empty pages", empty_pages);
+ if (lost_bytes)
+ print(", %" PRIu64 " bytes lost", lost_bytes);
+ print(", %" PRIuPTR " problems\n", traversal_problems);
+ }
+ } else if (verbose) {
+ print("Skipping b-tree walk...\n");
+ fflush(NULL);
+ }
+
+ if (!verbose)
+ print("Iterating DBIs...\n");
+ problems_maindb = process_db(~0u, /* MAIN_DBI */ NULL, NULL, false);
+ problems_freedb = process_db(FREE_DBI, "@GC", handle_freedb, false);
+
+ if (verbose) {
+ uint64_t value = envinfo.mi_mapsize / envstat.ms_psize;
+ double percent = value / 100.0;
+ print(" - space: %" PRIu64 " total pages", value);
+ print(", backed %" PRIu64 " (%.1f%%)", backed_pages,
+ backed_pages / percent);
+ print(", allocated %" PRIu64 " (%.1f%%)", alloc_pages,
+ alloc_pages / percent);
+
+ if (verbose > 1) {
+ value = envinfo.mi_mapsize / envstat.ms_psize - alloc_pages;
+ print(", remained %" PRIu64 " (%.1f%%)", value, value / percent);
+
+ value = alloc_pages - gc_pages;
+ print(", used %" PRIu64 " (%.1f%%)", value, value / percent);
+
+ print(", gc %" PRIu64 " (%.1f%%)", gc_pages, gc_pages / percent);
+
+ value = gc_pages - reclaimable_pages;
+ print(", detained %" PRIu64 " (%.1f%%)", value, value / percent);
+
+ print(", reclaimable %" PRIu64 " (%.1f%%)", reclaimable_pages,
+ reclaimable_pages / percent);
+ }
+
+ value =
+ envinfo.mi_mapsize / envstat.ms_psize - alloc_pages + reclaimable_pages;
+ print(", available %" PRIu64 " (%.1f%%)\n", value, value / percent);
+ }
+
+ if (problems_maindb == 0 && problems_freedb == 0) {
+ if (!dont_traversal &&
+ (envflags & (MDBX_EXCLUSIVE | MDBX_RDONLY)) != MDBX_RDONLY) {
+ if (walk.pgcount != alloc_pages - gc_pages) {
+ error("used pages mismatch (%" PRIu64 "(walked) != %" PRIu64
+ "(allocated - GC))\n",
+ walk.pgcount, alloc_pages - gc_pages);
+ }
+ if (unused_pages != gc_pages) {
+ error("gc pages mismatch (%" PRIu64 "(walked) != %" PRIu64 "(GC))\n",
+ unused_pages, gc_pages);
+ }
+ } else if (verbose) {
+ print(" - skip check used and gc pages (btree-traversal with "
+ "monopolistic or read-write mode only)\n");
+ }
+
+ if (!process_db(MAIN_DBI, NULL, handle_maindb, true)) {
+ if (!userdb_count && verbose)
+ print(" - does not contain multiple databases\n");
+ }
+ }
+
+bailout:
+ if (txn)
+ mdbx_txn_abort(txn);
+ if (locked)
+ mdbx_txn_unlock(env);
+ if (env)
+ mdbx_env_close(env);
+ fflush(NULL);
+ if (rc) {
+ if (rc < 0)
+ return (user_break) ? EXIT_INTERRUPTED : EXIT_FAILURE_SYS;
+ return EXIT_FAILURE_MDB;
+ }
+
+#if defined(_WIN32) || defined(_WIN64)
+ timestamp_finish = GetTickCount64();
+ elapsed = (timestamp_finish - timestamp_start) * 1e-3;
+#else
+ if (clock_gettime(CLOCK_MONOTONIC, ×tamp_finish)) {
+ rc = errno;
+ error("clock_gettime failed, error %d %s\n", rc, mdbx_strerror(rc));
+ return EXIT_FAILURE_SYS;
+ }
+ elapsed = timestamp_finish.tv_sec - timestamp_start.tv_sec +
+ (timestamp_finish.tv_nsec - timestamp_start.tv_nsec) * 1e-9;
+#endif /* !WINDOWS */
+
+ total_problems += problems_meta;
+ if (total_problems || problems_maindb || problems_freedb) {
+ print("Total %" PRIu64 " error%s detected, elapsed %.3f seconds.\n",
+ total_problems, (total_problems > 1) ? "s are" : " is", elapsed);
+ if (problems_meta || problems_maindb || problems_freedb)
+ return EXIT_FAILURE_CHECK_MAJOR;
+ return EXIT_FAILURE_CHECK_MINOR;
+ }
+ print("No error is detected, elapsed %.3f seconds\n", elapsed);
+ return EXIT_SUCCESS;
+}
diff --git a/contrib/db/libmdbx/src/tools/mdbx_copy.c b/contrib/db/libmdbx/src/tools/mdbx_copy.c
new file mode 100644
index 00000000..a58fd740
--- /dev/null
+++ b/contrib/db/libmdbx/src/tools/mdbx_copy.c
@@ -0,0 +1,130 @@
+/* mdbx_copy.c - memory-mapped database backup tool */
+
+/*
+ * Copyright 2015-2019 Leonid Yuriev
+ * and other libmdbx authors: please see AUTHORS file.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted only as authorized by the OpenLDAP
+ * Public License.
+ *
+ * A copy of this license is available in the file LICENSE in the
+ * top-level directory of the distribution or, alternatively, at
+ * . */
+
+#ifdef _MSC_VER
+#if _MSC_VER > 1800
+#pragma warning(disable : 4464) /* relative include path contains '..' */
+#endif
+#pragma warning(disable : 4996) /* The POSIX name is deprecated... */
+#endif /* _MSC_VER (warnings) */
+
+#define MDBX_TOOLS /* Avoid using internal mdbx_assert() */
+#include "../elements/internals.h"
+
+#if defined(_WIN32) || defined(_WIN64)
+#include "wingetopt.h"
+
+static volatile BOOL user_break;
+static BOOL WINAPI ConsoleBreakHandlerRoutine(DWORD dwCtrlType) {
+ (void)dwCtrlType;
+ user_break = true;
+ return true;
+}
+
+#else /* WINDOWS */
+
+static volatile sig_atomic_t user_break;
+static void signal_handler(int sig) {
+ (void)sig;
+ user_break = 1;
+}
+
+#endif /* !WINDOWS */
+
+int main(int argc, char *argv[]) {
+ int rc;
+ MDBX_env *env = NULL;
+ const char *progname = argv[0], *act;
+ unsigned flags = MDBX_RDONLY;
+ unsigned cpflags = 0;
+ bool quiet = false;
+
+ for (; argc > 1 && argv[1][0] == '-'; argc--, argv++) {
+ if (argv[1][1] == 'n' && argv[1][2] == '\0')
+ flags |= MDBX_NOSUBDIR;
+ else if (argv[1][1] == 'c' && argv[1][2] == '\0')
+ cpflags |= MDBX_CP_COMPACT;
+ else if (argv[1][1] == 'q' && argv[1][2] == '\0')
+ quiet = true;
+ else if (argv[1][1] == 'V' && argv[1][2] == '\0') {
+ printf("mdbx_copy version %d.%d.%d.%d\n"
+ " - source: %s %s, commit %s, tree %s\n"
+ " - anchor: %s\n"
+ " - build: %s for %s by %s\n"
+ " - flags: %s\n"
+ " - options: %s\n",
+ mdbx_version.major, mdbx_version.minor, mdbx_version.release,
+ mdbx_version.revision, mdbx_version.git.describe,
+ mdbx_version.git.datetime, mdbx_version.git.commit,
+ mdbx_version.git.tree, mdbx_sourcery_anchor, mdbx_build.datetime,
+ mdbx_build.target, mdbx_build.compiler, mdbx_build.flags,
+ mdbx_build.options);
+ return EXIT_SUCCESS;
+ } else
+ argc = 0;
+ }
+
+ if (argc < 2 || argc > 3) {
+ fprintf(stderr, "usage: %s [-V] [-q] [-c] [-n] srcpath [dstpath]\n",
+ progname);
+ exit(EXIT_FAILURE);
+ }
+
+#if defined(_WIN32) || defined(_WIN64)
+ SetConsoleCtrlHandler(ConsoleBreakHandlerRoutine, true);
+#else
+#ifdef SIGPIPE
+ signal(SIGPIPE, signal_handler);
+#endif
+#ifdef SIGHUP
+ signal(SIGHUP, signal_handler);
+#endif
+ signal(SIGINT, signal_handler);
+ signal(SIGTERM, signal_handler);
+#endif /* !WINDOWS */
+
+ if (!quiet) {
+ fprintf((argc == 2) ? stderr : stdout,
+ "mdbx_copy %s (%s, T-%s)\nRunning for copy %s to %s...\n",
+ mdbx_version.git.describe, mdbx_version.git.datetime,
+ mdbx_version.git.tree, argv[1], (argc == 2) ? "stdout" : argv[2]);
+ fflush(NULL);
+ }
+
+ act = "opening environment";
+ rc = mdbx_env_create(&env);
+ if (rc == MDBX_SUCCESS) {
+ rc = mdbx_env_open(env, argv[1], flags, 0640);
+ }
+ if (rc == MDBX_SUCCESS) {
+ act = "copying";
+ if (argc == 2) {
+ mdbx_filehandle_t fd;
+#if defined(_WIN32) || defined(_WIN64)
+ fd = GetStdHandle(STD_OUTPUT_HANDLE);
+#else
+ fd = fileno(stdout);
+#endif
+ rc = mdbx_env_copy2fd(env, fd, cpflags);
+ } else
+ rc = mdbx_env_copy(env, argv[2], cpflags);
+ }
+ if (rc)
+ fprintf(stderr, "%s: %s failed, error %d (%s)\n", progname, act, rc,
+ mdbx_strerror(rc));
+ mdbx_env_close(env);
+
+ return rc ? EXIT_FAILURE : EXIT_SUCCESS;
+}
diff --git a/contrib/db/libmdbx/src/tools/mdbx_dump.c b/contrib/db/libmdbx/src/tools/mdbx_dump.c
new file mode 100644
index 00000000..20cd3762
--- /dev/null
+++ b/contrib/db/libmdbx/src/tools/mdbx_dump.c
@@ -0,0 +1,352 @@
+/* mdbx_dump.c - memory-mapped database dump tool */
+
+/*
+ * Copyright 2015-2019 Leonid Yuriev
+ * and other libmdbx authors: please see AUTHORS file.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted only as authorized by the OpenLDAP
+ * Public License.
+ *
+ * A copy of this license is available in the file LICENSE in the
+ * top-level directory of the distribution or, alternatively, at
+ * . */
+
+#ifdef _MSC_VER
+#if _MSC_VER > 1800
+#pragma warning(disable : 4464) /* relative include path contains '..' */
+#endif
+#pragma warning(disable : 4996) /* The POSIX name is deprecated... */
+#endif /* _MSC_VER (warnings) */
+
+#define MDBX_TOOLS /* Avoid using internal mdbx_assert() */
+#include "../elements/internals.h"
+
+#include
+
+#define PRINT 1
+static int mode;
+
+typedef struct flagbit {
+ int bit;
+ char *name;
+} flagbit;
+
+flagbit dbflags[] = {{MDBX_REVERSEKEY, "reversekey"},
+ {MDBX_DUPSORT, "dupsort"},
+ {MDBX_INTEGERKEY, "integerkey"},
+ {MDBX_DUPFIXED, "dupfixed"},
+ {MDBX_INTEGERDUP, "integerdup"},
+ {MDBX_REVERSEDUP, "reversedup"},
+ {0, NULL}};
+
+#if defined(_WIN32) || defined(_WIN64)
+#include "wingetopt.h"
+
+static volatile BOOL user_break;
+static BOOL WINAPI ConsoleBreakHandlerRoutine(DWORD dwCtrlType) {
+ (void)dwCtrlType;
+ user_break = true;
+ return true;
+}
+
+#else /* WINDOWS */
+
+static volatile sig_atomic_t user_break;
+static void signal_handler(int sig) {
+ (void)sig;
+ user_break = 1;
+}
+
+#endif /* !WINDOWS */
+
+static const char hexc[] = "0123456789abcdef";
+
+static void dumpbyte(unsigned char c) {
+ putchar(hexc[c >> 4]);
+ putchar(hexc[c & 0xf]);
+}
+
+static void text(MDBX_val *v) {
+ unsigned char *c, *end;
+
+ putchar(' ');
+ c = v->iov_base;
+ end = c + v->iov_len;
+ while (c < end) {
+ if (isprint(*c) && *c != '\\') {
+ putchar(*c);
+ } else {
+ putchar('\\');
+ dumpbyte(*c);
+ }
+ c++;
+ }
+ putchar('\n');
+}
+
+static void dumpval(MDBX_val *v) {
+ unsigned char *c, *end;
+
+ putchar(' ');
+ c = v->iov_base;
+ end = c + v->iov_len;
+ while (c < end) {
+ dumpbyte(*c++);
+ }
+ putchar('\n');
+}
+
+/* Dump in BDB-compatible format */
+static int dumpit(MDBX_txn *txn, MDBX_dbi dbi, char *name) {
+ MDBX_cursor *mc;
+ MDBX_stat ms;
+ MDBX_val key, data;
+ MDBX_envinfo info;
+ unsigned int flags;
+ int rc, i;
+
+ rc = mdbx_dbi_flags(txn, dbi, &flags);
+ if (rc)
+ return rc;
+
+ rc = mdbx_dbi_stat(txn, dbi, &ms, sizeof(ms));
+ if (rc)
+ return rc;
+
+ rc = mdbx_env_info(mdbx_txn_env(txn), &info, sizeof(info));
+ if (rc)
+ return rc;
+
+ printf("VERSION=3\n");
+ printf("format=%s\n", mode & PRINT ? "print" : "bytevalue");
+ if (name)
+ printf("database=%s\n", name);
+ printf("type=btree\n");
+ printf("mapsize=%" PRIu64 "\n", info.mi_mapsize);
+ printf("maxreaders=%u\n", info.mi_maxreaders);
+
+ for (i = 0; dbflags[i].bit; i++)
+ if (flags & dbflags[i].bit)
+ printf("%s=1\n", dbflags[i].name);
+
+ printf("db_pagesize=%d\n", ms.ms_psize);
+ printf("HEADER=END\n");
+
+ rc = mdbx_cursor_open(txn, dbi, &mc);
+ if (rc)
+ return rc;
+
+ while ((rc = mdbx_cursor_get(mc, &key, &data, MDBX_NEXT)) == MDBX_SUCCESS) {
+ if (user_break) {
+ rc = MDBX_EINTR;
+ break;
+ }
+ if (mode & PRINT) {
+ text(&key);
+ text(&data);
+ } else {
+ dumpval(&key);
+ dumpval(&data);
+ }
+ }
+ printf("DATA=END\n");
+ if (rc == MDBX_NOTFOUND)
+ rc = MDBX_SUCCESS;
+
+ return rc;
+}
+
+static void usage(char *prog) {
+ fprintf(stderr,
+ "usage: %s [-V] [-f output] [-l] [-n] [-p] [-a|-s subdb] dbpath\n",
+ prog);
+ exit(EXIT_FAILURE);
+}
+
+int main(int argc, char *argv[]) {
+ int i, rc;
+ MDBX_env *env;
+ MDBX_txn *txn;
+ MDBX_dbi dbi;
+ char *prog = argv[0];
+ char *envname;
+ char *subname = NULL;
+ int alldbs = 0, envflags = 0, list = 0;
+
+ if (argc < 2)
+ usage(prog);
+
+ /* -a: dump main DB and all subDBs
+ * -s: dump only the named subDB
+ * -n: use NOSUBDIR flag on env_open
+ * -p: use printable characters
+ * -f: write to file instead of stdout
+ * -V: print version and exit
+ * (default) dump only the main DB
+ */
+ while ((i = getopt(argc, argv, "af:lnps:V")) != EOF) {
+ switch (i) {
+ case 'V':
+ printf("mdbx_dump version %d.%d.%d.%d\n"
+ " - source: %s %s, commit %s, tree %s\n"
+ " - anchor: %s\n"
+ " - build: %s for %s by %s\n"
+ " - flags: %s\n"
+ " - options: %s\n",
+ mdbx_version.major, mdbx_version.minor, mdbx_version.release,
+ mdbx_version.revision, mdbx_version.git.describe,
+ mdbx_version.git.datetime, mdbx_version.git.commit,
+ mdbx_version.git.tree, mdbx_sourcery_anchor, mdbx_build.datetime,
+ mdbx_build.target, mdbx_build.compiler, mdbx_build.flags,
+ mdbx_build.options);
+ return EXIT_SUCCESS;
+ case 'l':
+ list = 1;
+ /*FALLTHROUGH*/;
+ __fallthrough;
+ case 'a':
+ if (subname)
+ usage(prog);
+ alldbs++;
+ break;
+ case 'f':
+ if (freopen(optarg, "w", stdout) == NULL) {
+ fprintf(stderr, "%s: %s: reopen: %s\n", prog, optarg,
+ mdbx_strerror(errno));
+ exit(EXIT_FAILURE);
+ }
+ break;
+ case 'n':
+ envflags |= MDBX_NOSUBDIR;
+ break;
+ case 'p':
+ mode |= PRINT;
+ break;
+ case 's':
+ if (alldbs)
+ usage(prog);
+ subname = optarg;
+ break;
+ default:
+ usage(prog);
+ }
+ }
+
+ if (optind != argc - 1)
+ usage(prog);
+
+#if defined(_WIN32) || defined(_WIN64)
+ SetConsoleCtrlHandler(ConsoleBreakHandlerRoutine, true);
+#else
+#ifdef SIGPIPE
+ signal(SIGPIPE, signal_handler);
+#endif
+#ifdef SIGHUP
+ signal(SIGHUP, signal_handler);
+#endif
+ signal(SIGINT, signal_handler);
+ signal(SIGTERM, signal_handler);
+#endif /* !WINDOWS */
+
+ envname = argv[optind];
+ printf("mdbx_dump %s (%s, T-%s)\nRunning for %s...\n",
+ mdbx_version.git.describe, mdbx_version.git.datetime,
+ mdbx_version.git.tree, envname);
+ fflush(NULL);
+
+ rc = mdbx_env_create(&env);
+ if (rc) {
+ fprintf(stderr, "mdbx_env_create failed, error %d %s\n", rc,
+ mdbx_strerror(rc));
+ return EXIT_FAILURE;
+ }
+
+ if (alldbs || subname) {
+ mdbx_env_set_maxdbs(env, 2);
+ }
+
+ rc = mdbx_env_open(env, envname, envflags | MDBX_RDONLY, 0664);
+ if (rc) {
+ fprintf(stderr, "mdbx_env_open failed, error %d %s\n", rc,
+ mdbx_strerror(rc));
+ goto env_close;
+ }
+
+ rc = mdbx_txn_begin(env, NULL, MDBX_RDONLY, &txn);
+ if (rc) {
+ fprintf(stderr, "mdbx_txn_begin failed, error %d %s\n", rc,
+ mdbx_strerror(rc));
+ goto env_close;
+ }
+
+ rc = mdbx_dbi_open(txn, subname, 0, &dbi);
+ if (rc) {
+ fprintf(stderr, "mdbx_open failed, error %d %s\n", rc, mdbx_strerror(rc));
+ goto txn_abort;
+ }
+
+ if (alldbs) {
+ MDBX_cursor *cursor;
+ MDBX_val key;
+ int count = 0;
+
+ rc = mdbx_cursor_open(txn, dbi, &cursor);
+ if (rc) {
+ fprintf(stderr, "mdbx_cursor_open failed, error %d %s\n", rc,
+ mdbx_strerror(rc));
+ goto txn_abort;
+ }
+ while ((rc = mdbx_cursor_get(cursor, &key, NULL, MDBX_NEXT_NODUP)) == 0) {
+ if (user_break) {
+ rc = MDBX_EINTR;
+ break;
+ }
+ char *str;
+ MDBX_dbi db2;
+ if (memchr(key.iov_base, '\0', key.iov_len))
+ continue;
+ count++;
+ str = mdbx_malloc(key.iov_len + 1);
+ memcpy(str, key.iov_base, key.iov_len);
+ str[key.iov_len] = '\0';
+ rc = mdbx_dbi_open(txn, str, 0, &db2);
+ if (rc == MDBX_SUCCESS) {
+ if (list) {
+ printf("%s\n", str);
+ list++;
+ } else {
+ rc = dumpit(txn, db2, str);
+ if (rc)
+ break;
+ }
+ mdbx_dbi_close(env, db2);
+ }
+ mdbx_free(str);
+ if (rc)
+ continue;
+ }
+ mdbx_cursor_close(cursor);
+ if (!count) {
+ fprintf(stderr, "%s: %s does not contain multiple databases\n", prog,
+ envname);
+ rc = MDBX_NOTFOUND;
+ } else if (rc == MDBX_INCOMPATIBLE) {
+ /* LY: the record it not a named sub-db. */
+ rc = MDBX_SUCCESS;
+ }
+ } else {
+ rc = dumpit(txn, dbi, subname);
+ }
+ if (rc && rc != MDBX_NOTFOUND)
+ fprintf(stderr, "%s: %s: %s\n", prog, envname, mdbx_strerror(rc));
+
+ mdbx_dbi_close(env, dbi);
+txn_abort:
+ mdbx_txn_abort(txn);
+env_close:
+ mdbx_env_close(env);
+
+ return rc ? EXIT_FAILURE : EXIT_SUCCESS;
+}
diff --git a/contrib/db/libmdbx/src/tools/mdbx_load.c b/contrib/db/libmdbx/src/tools/mdbx_load.c
new file mode 100644
index 00000000..00bfa87e
--- /dev/null
+++ b/contrib/db/libmdbx/src/tools/mdbx_load.c
@@ -0,0 +1,567 @@
+/* mdbx_load.c - memory-mapped database load tool */
+
+/*
+ * Copyright 2015-2019 Leonid Yuriev
+ * and other libmdbx authors: please see AUTHORS file.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted only as authorized by the OpenLDAP
+ * Public License.
+ *
+ * A copy of this license is available in the file LICENSE in the
+ * top-level directory of the distribution or, alternatively, at
+ * . */
+
+#ifdef _MSC_VER
+#if _MSC_VER > 1800
+#pragma warning(disable : 4464) /* relative include path contains '..' */
+#endif
+#pragma warning(disable : 4996) /* The POSIX name is deprecated... */
+#endif /* _MSC_VER (warnings) */
+
+#define MDBX_TOOLS /* Avoid using internal mdbx_assert() */
+#include "../elements/internals.h"
+
+#include
+
+#if defined(_WIN32) || defined(_WIN64)
+#include "wingetopt.h"
+
+static volatile BOOL user_break;
+static BOOL WINAPI ConsoleBreakHandlerRoutine(DWORD dwCtrlType) {
+ (void)dwCtrlType;
+ user_break = true;
+ return true;
+}
+
+#else /* WINDOWS */
+
+static volatile sig_atomic_t user_break;
+static void signal_handler(int sig) {
+ (void)sig;
+ user_break = 1;
+}
+
+#endif /* !WINDOWS */
+
+#define PRINT 1
+#define NOHDR 2
+static int mode;
+
+static char *subname = NULL;
+static size_t lineno;
+static int version;
+
+static int dbi_flags;
+static char *prog;
+static int Eof;
+
+static MDBX_envinfo envinfo;
+static MDBX_val kbuf, dbuf;
+static MDBX_val k0buf;
+
+#define STRLENOF(s) (sizeof(s) - 1)
+
+typedef struct flagbit {
+ int bit;
+ char *name;
+ int len;
+} flagbit;
+
+#define S(s) s, STRLENOF(s)
+
+flagbit dbflags[] = {{MDBX_REVERSEKEY, S("reversekey")},
+ {MDBX_DUPSORT, S("dupsort")},
+ {MDBX_INTEGERKEY, S("integerkey")},
+ {MDBX_DUPFIXED, S("dupfixed")},
+ {MDBX_INTEGERDUP, S("integerdup")},
+ {MDBX_REVERSEDUP, S("reversedup")},
+ {0, NULL, 0}};
+
+static void readhdr(void) {
+ char *ptr;
+
+ dbi_flags = 0;
+ while (fgets(dbuf.iov_base, (int)dbuf.iov_len, stdin) != NULL) {
+ lineno++;
+ if (!strncmp(dbuf.iov_base, "db_pagesize=", STRLENOF("db_pagesize=")) ||
+ !strncmp(dbuf.iov_base, "duplicates=", STRLENOF("duplicates="))) {
+ /* LY: silently ignore information fields. */
+ continue;
+ } else if (!strncmp(dbuf.iov_base, "VERSION=", STRLENOF("VERSION="))) {
+ version = atoi((char *)dbuf.iov_base + STRLENOF("VERSION="));
+ if (version > 3) {
+ fprintf(stderr, "%s: line %" PRIiSIZE ": unsupported VERSION %d\n",
+ prog, lineno, version);
+ exit(EXIT_FAILURE);
+ }
+ } else if (!strncmp(dbuf.iov_base, "HEADER=END", STRLENOF("HEADER=END"))) {
+ break;
+ } else if (!strncmp(dbuf.iov_base, "format=", STRLENOF("format="))) {
+ if (!strncmp((char *)dbuf.iov_base + STRLENOF("FORMAT="), "print",
+ STRLENOF("print")))
+ mode |= PRINT;
+ else if (strncmp((char *)dbuf.iov_base + STRLENOF("FORMAT="), "bytevalue",
+ STRLENOF("bytevalue"))) {
+ fprintf(stderr, "%s: line %" PRIiSIZE ": unsupported FORMAT %s\n", prog,
+ lineno, (char *)dbuf.iov_base + STRLENOF("FORMAT="));
+ exit(EXIT_FAILURE);
+ }
+ } else if (!strncmp(dbuf.iov_base, "database=", STRLENOF("database="))) {
+ ptr = memchr(dbuf.iov_base, '\n', dbuf.iov_len);
+ if (ptr)
+ *ptr = '\0';
+ if (subname)
+ mdbx_free(subname);
+ subname = mdbx_strdup((char *)dbuf.iov_base + STRLENOF("database="));
+ } else if (!strncmp(dbuf.iov_base, "type=", STRLENOF("type="))) {
+ if (strncmp((char *)dbuf.iov_base + STRLENOF("type="), "btree",
+ STRLENOF("btree"))) {
+ fprintf(stderr, "%s: line %" PRIiSIZE ": unsupported type %s\n", prog,
+ lineno, (char *)dbuf.iov_base + STRLENOF("type="));
+ exit(EXIT_FAILURE);
+ }
+ } else if (!strncmp(dbuf.iov_base, "mapaddr=", STRLENOF("mapaddr="))) {
+ int i;
+ ptr = memchr(dbuf.iov_base, '\n', dbuf.iov_len);
+ if (ptr)
+ *ptr = '\0';
+ void *unused;
+ i = sscanf((char *)dbuf.iov_base + STRLENOF("mapaddr="), "%p", &unused);
+ if (i != 1) {
+ fprintf(stderr, "%s: line %" PRIiSIZE ": invalid mapaddr %s\n", prog,
+ lineno, (char *)dbuf.iov_base + STRLENOF("mapaddr="));
+ exit(EXIT_FAILURE);
+ }
+ } else if (!strncmp(dbuf.iov_base, "mapsize=", STRLENOF("mapsize="))) {
+ int i;
+ ptr = memchr(dbuf.iov_base, '\n', dbuf.iov_len);
+ if (ptr)
+ *ptr = '\0';
+ i = sscanf((char *)dbuf.iov_base + STRLENOF("mapsize="), "%" PRIu64,
+ &envinfo.mi_mapsize);
+ if (i != 1) {
+ fprintf(stderr, "%s: line %" PRIiSIZE ": invalid mapsize %s\n", prog,
+ lineno, (char *)dbuf.iov_base + STRLENOF("mapsize="));
+ exit(EXIT_FAILURE);
+ }
+ } else if (!strncmp(dbuf.iov_base,
+ "maxreaders=", STRLENOF("maxreaders="))) {
+ int i;
+ ptr = memchr(dbuf.iov_base, '\n', dbuf.iov_len);
+ if (ptr)
+ *ptr = '\0';
+ i = sscanf((char *)dbuf.iov_base + STRLENOF("maxreaders="), "%u",
+ &envinfo.mi_maxreaders);
+ if (i != 1) {
+ fprintf(stderr, "%s: line %" PRIiSIZE ": invalid maxreaders %s\n", prog,
+ lineno, (char *)dbuf.iov_base + STRLENOF("maxreaders="));
+ exit(EXIT_FAILURE);
+ }
+ } else {
+ int i;
+ for (i = 0; dbflags[i].bit; i++) {
+ if (!strncmp(dbuf.iov_base, dbflags[i].name, dbflags[i].len) &&
+ ((char *)dbuf.iov_base)[dbflags[i].len] == '=') {
+ if (((char *)dbuf.iov_base)[dbflags[i].len + 1] == '1')
+ dbi_flags |= dbflags[i].bit;
+ break;
+ }
+ }
+ if (!dbflags[i].bit) {
+ ptr = memchr(dbuf.iov_base, '=', dbuf.iov_len);
+ if (!ptr) {
+ fprintf(stderr, "%s: line %" PRIiSIZE ": unexpected format\n", prog,
+ lineno);
+ exit(EXIT_FAILURE);
+ } else {
+ *ptr = '\0';
+ fprintf(stderr,
+ "%s: line %" PRIiSIZE ": unrecognized keyword ignored: %s\n",
+ prog, lineno, (char *)dbuf.iov_base);
+ }
+ }
+ }
+ }
+}
+
+static void badend(void) {
+ fprintf(stderr, "%s: line %" PRIiSIZE ": unexpected end of input\n", prog,
+ lineno);
+}
+
+static int unhex(unsigned char *c2) {
+ int x, c;
+ x = *c2++ & 0x4f;
+ if (x & 0x40)
+ x -= 55;
+ c = x << 4;
+ x = *c2 & 0x4f;
+ if (x & 0x40)
+ x -= 55;
+ c |= x;
+ return c;
+}
+
+static int readline(MDBX_val *out, MDBX_val *buf) {
+ unsigned char *c1, *c2, *end;
+ size_t len, l2;
+ int c;
+
+ if (!(mode & NOHDR)) {
+ c = fgetc(stdin);
+ if (c == EOF) {
+ Eof = 1;
+ return EOF;
+ }
+ if (c != ' ') {
+ lineno++;
+ if (fgets(buf->iov_base, (int)buf->iov_len, stdin) == NULL) {
+ badend:
+ Eof = 1;
+ badend();
+ return EOF;
+ }
+ if (c == 'D' && !strncmp(buf->iov_base, "ATA=END", STRLENOF("ATA=END")))
+ return EOF;
+ goto badend;
+ }
+ }
+ if (fgets(buf->iov_base, (int)buf->iov_len, stdin) == NULL) {
+ Eof = 1;
+ return EOF;
+ }
+ lineno++;
+
+ c1 = buf->iov_base;
+ len = strlen((char *)c1);
+ l2 = len;
+
+ /* Is buffer too short? */
+ while (c1[len - 1] != '\n') {
+ buf->iov_base = mdbx_realloc(buf->iov_base, buf->iov_len * 2);
+ if (!buf->iov_base) {
+ Eof = 1;
+ fprintf(stderr, "%s: line %" PRIiSIZE ": out of memory, line too long\n",
+ prog, lineno);
+ return EOF;
+ }
+ c1 = buf->iov_base;
+ c1 += l2;
+ if (fgets((char *)c1, (int)buf->iov_len + 1, stdin) == NULL) {
+ Eof = 1;
+ badend();
+ return EOF;
+ }
+ buf->iov_len *= 2;
+ len = strlen((char *)c1);
+ l2 += len;
+ }
+ c1 = c2 = buf->iov_base;
+ len = l2;
+ c1[--len] = '\0';
+ end = c1 + len;
+
+ if (mode & PRINT) {
+ while (c2 < end) {
+ if (unlikely(*c2 == '\\')) {
+ if (c2[1] == '\\') {
+ *c1++ = '\\';
+ } else {
+ if (c2 + 3 > end || !isxdigit(c2[1]) || !isxdigit(c2[2])) {
+ Eof = 1;
+ badend();
+ return EOF;
+ }
+ *c1++ = (char)unhex(++c2);
+ }
+ c2 += 2;
+ } else {
+ /* copies are redundant when no escapes were used */
+ *c1++ = *c2++;
+ }
+ }
+ } else {
+ /* odd length not allowed */
+ if (len & 1) {
+ Eof = 1;
+ badend();
+ return EOF;
+ }
+ while (c2 < end) {
+ if (!isxdigit(*c2) || !isxdigit(c2[1])) {
+ Eof = 1;
+ badend();
+ return EOF;
+ }
+ *c1++ = (char)unhex(c2);
+ c2 += 2;
+ }
+ }
+ c2 = out->iov_base = buf->iov_base;
+ out->iov_len = c1 - c2;
+
+ return 0;
+}
+
+static void usage(void) {
+ fprintf(stderr,
+ "usage: %s [-V] [-a] [-f input] [-n] [-s name] [-N] [-T] dbpath\n",
+ prog);
+ exit(EXIT_FAILURE);
+}
+
+static int anyway_greater(const MDBX_val *a, const MDBX_val *b) {
+ (void)a;
+ (void)b;
+ return 1;
+}
+
+int main(int argc, char *argv[]) {
+ int i, rc;
+ MDBX_env *env = NULL;
+ MDBX_txn *txn = NULL;
+ MDBX_cursor *mc = NULL;
+ MDBX_dbi dbi;
+ char *envname = NULL;
+ int envflags = MDBX_UTTERLY_NOSYNC, putflags = 0;
+ int append = 0;
+ MDBX_val prevk;
+
+ prog = argv[0];
+ if (argc < 2)
+ usage();
+
+ /* -a: append records in input order
+ * -f: load file instead of stdin
+ * -n: use NOSUBDIR flag on env_open
+ * -s: load into named subDB
+ * -N: use NOOVERWRITE on puts
+ * -T: read plaintext
+ * -V: print version and exit
+ */
+ while ((i = getopt(argc, argv, "af:ns:NTV")) != EOF) {
+ switch (i) {
+ case 'V':
+ printf("mdbx_load version %d.%d.%d.%d\n"
+ " - source: %s %s, commit %s, tree %s\n"
+ " - anchor: %s\n"
+ " - build: %s for %s by %s\n"
+ " - flags: %s\n"
+ " - options: %s\n",
+ mdbx_version.major, mdbx_version.minor, mdbx_version.release,
+ mdbx_version.revision, mdbx_version.git.describe,
+ mdbx_version.git.datetime, mdbx_version.git.commit,
+ mdbx_version.git.tree, mdbx_sourcery_anchor, mdbx_build.datetime,
+ mdbx_build.target, mdbx_build.compiler, mdbx_build.flags,
+ mdbx_build.options);
+ return EXIT_SUCCESS;
+ case 'a':
+ append = 1;
+ break;
+ case 'f':
+ if (freopen(optarg, "r", stdin) == NULL) {
+ fprintf(stderr, "%s: %s: reopen: %s\n", prog, optarg,
+ mdbx_strerror(errno));
+ exit(EXIT_FAILURE);
+ }
+ break;
+ case 'n':
+ envflags |= MDBX_NOSUBDIR;
+ break;
+ case 's':
+ subname = mdbx_strdup(optarg);
+ break;
+ case 'N':
+ putflags = MDBX_NOOVERWRITE | MDBX_NODUPDATA;
+ break;
+ case 'T':
+ mode |= NOHDR | PRINT;
+ break;
+ default:
+ usage();
+ }
+ }
+
+ if (optind != argc - 1)
+ usage();
+
+#if defined(_WIN32) || defined(_WIN64)
+ SetConsoleCtrlHandler(ConsoleBreakHandlerRoutine, true);
+#else
+#ifdef SIGPIPE
+ signal(SIGPIPE, signal_handler);
+#endif
+#ifdef SIGHUP
+ signal(SIGHUP, signal_handler);
+#endif
+ signal(SIGINT, signal_handler);
+ signal(SIGTERM, signal_handler);
+#endif /* !WINDOWS */
+
+ envname = argv[optind];
+ printf("mdbx_load %s (%s, T-%s)\nRunning for %s...\n",
+ mdbx_version.git.describe, mdbx_version.git.datetime,
+ mdbx_version.git.tree, envname);
+ fflush(NULL);
+
+ dbuf.iov_len = 4096;
+ dbuf.iov_base = mdbx_malloc(dbuf.iov_len);
+
+ /* read first header for mapsize= */
+ if (!(mode & NOHDR))
+ readhdr();
+
+ rc = mdbx_env_create(&env);
+ if (rc) {
+ fprintf(stderr, "mdbx_env_create failed, error %d %s\n", rc,
+ mdbx_strerror(rc));
+ return EXIT_FAILURE;
+ }
+
+ mdbx_env_set_maxdbs(env, 2);
+
+ if (envinfo.mi_maxreaders)
+ mdbx_env_set_maxreaders(env, envinfo.mi_maxreaders);
+
+ if (envinfo.mi_mapsize) {
+ if (envinfo.mi_mapsize > SIZE_MAX) {
+ fprintf(stderr, "mdbx_env_set_mapsize failed, error %d %s\n", rc,
+ mdbx_strerror(MDBX_TOO_LARGE));
+ return EXIT_FAILURE;
+ }
+ mdbx_env_set_mapsize(env, (size_t)envinfo.mi_mapsize);
+ }
+
+#ifdef MDBX_FIXEDMAP
+ if (info.mi_mapaddr)
+ envflags |= MDBX_FIXEDMAP;
+#endif
+
+ rc = mdbx_env_open(env, envname, envflags, 0664);
+ if (rc) {
+ fprintf(stderr, "mdbx_env_open failed, error %d %s\n", rc,
+ mdbx_strerror(rc));
+ goto env_close;
+ }
+
+ kbuf.iov_len = mdbx_env_get_maxkeysize(env);
+ if (kbuf.iov_len >= SIZE_MAX / 4) {
+ fprintf(stderr, "mdbx_env_get_maxkeysize failed, returns %zu\n",
+ kbuf.iov_len);
+ goto env_close;
+ }
+ kbuf.iov_len = (kbuf.iov_len + 1) * 2;
+ kbuf.iov_base = malloc(kbuf.iov_len * 2);
+ k0buf.iov_len = kbuf.iov_len;
+ k0buf.iov_base = (char *)kbuf.iov_base + kbuf.iov_len;
+ prevk.iov_base = k0buf.iov_base;
+
+ while (!Eof) {
+ if (user_break) {
+ rc = MDBX_EINTR;
+ break;
+ }
+
+ rc = mdbx_txn_begin(env, NULL, 0, &txn);
+ if (rc) {
+ fprintf(stderr, "mdbx_txn_begin failed, error %d %s\n", rc,
+ mdbx_strerror(rc));
+ goto env_close;
+ }
+
+ rc = mdbx_dbi_open_ex(txn, subname, dbi_flags | MDBX_CREATE, &dbi,
+ append ? anyway_greater : NULL,
+ append ? anyway_greater : NULL);
+ if (rc) {
+ fprintf(stderr, "mdbx_open failed, error %d %s\n", rc, mdbx_strerror(rc));
+ goto txn_abort;
+ }
+
+ rc = mdbx_cursor_open(txn, dbi, &mc);
+ if (rc) {
+ fprintf(stderr, "mdbx_cursor_open failed, error %d %s\n", rc,
+ mdbx_strerror(rc));
+ goto txn_abort;
+ }
+
+ int batch = 0;
+ prevk.iov_len = 0;
+ while (1) {
+ MDBX_val key;
+ rc = readline(&key, &kbuf);
+ if (rc) /* rc == EOF */
+ break;
+
+ MDBX_val data;
+ rc = readline(&data, &dbuf);
+ if (rc) {
+ fprintf(stderr, "%s: line %" PRIiSIZE ": failed to read key value\n",
+ prog, lineno);
+ goto txn_abort;
+ }
+
+ int appflag = 0;
+ if (append) {
+ appflag = MDBX_APPEND;
+ if (dbi_flags & MDBX_DUPSORT) {
+ if (prevk.iov_len == key.iov_len &&
+ memcmp(prevk.iov_base, key.iov_base, key.iov_len) == 0)
+ appflag = MDBX_APPEND | MDBX_APPENDDUP;
+ else
+ memcpy(prevk.iov_base, key.iov_base, prevk.iov_len = key.iov_len);
+ }
+ }
+ rc = mdbx_cursor_put(mc, &key, &data, putflags | appflag);
+ if (rc == MDBX_KEYEXIST && putflags)
+ continue;
+ if (rc) {
+ fprintf(stderr, "mdbx_cursor_put failed, error %d %s\n", rc,
+ mdbx_strerror(rc));
+ goto txn_abort;
+ }
+ batch++;
+ if (batch == 100) {
+ rc = mdbx_txn_commit(txn);
+ if (rc) {
+ fprintf(stderr, "%s: line %" PRIiSIZE ": txn_commit: %s\n", prog,
+ lineno, mdbx_strerror(rc));
+ goto env_close;
+ }
+ rc = mdbx_txn_begin(env, NULL, 0, &txn);
+ if (rc) {
+ fprintf(stderr, "mdbx_txn_begin failed, error %d %s\n", rc,
+ mdbx_strerror(rc));
+ goto env_close;
+ }
+ rc = mdbx_cursor_open(txn, dbi, &mc);
+ if (rc) {
+ fprintf(stderr, "mdbx_cursor_open failed, error %d %s\n", rc,
+ mdbx_strerror(rc));
+ goto txn_abort;
+ }
+ batch = 0;
+ }
+ }
+ rc = mdbx_txn_commit(txn);
+ txn = NULL;
+ if (rc) {
+ fprintf(stderr, "%s: line %" PRIiSIZE ": txn_commit: %s\n", prog, lineno,
+ mdbx_strerror(rc));
+ goto env_close;
+ }
+ mdbx_dbi_close(env, dbi);
+
+ /* try read next header */
+ if (!(mode & NOHDR))
+ readhdr();
+ }
+
+txn_abort:
+ mdbx_txn_abort(txn);
+env_close:
+ mdbx_env_close(env);
+
+ return rc ? EXIT_FAILURE : EXIT_SUCCESS;
+}
diff --git a/contrib/db/libmdbx/src/tools/mdbx_stat.c b/contrib/db/libmdbx/src/tools/mdbx_stat.c
new file mode 100644
index 00000000..04c1fb93
--- /dev/null
+++ b/contrib/db/libmdbx/src/tools/mdbx_stat.c
@@ -0,0 +1,436 @@
+/* mdbx_stat.c - memory-mapped database status tool */
+
+/*
+ * Copyright 2015-2019 Leonid Yuriev
+ * and other libmdbx authors: please see AUTHORS file.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted only as authorized by the OpenLDAP
+ * Public License.
+ *
+ * A copy of this license is available in the file LICENSE in the
+ * top-level directory of the distribution or, alternatively, at
+ * . */
+
+#ifdef _MSC_VER
+#if _MSC_VER > 1800
+#pragma warning(disable : 4464) /* relative include path contains '..' */
+#endif
+#pragma warning(disable : 4996) /* The POSIX name is deprecated... */
+#endif /* _MSC_VER (warnings) */
+
+#define MDBX_TOOLS /* Avoid using internal mdbx_assert() */
+#include "../elements/internals.h"
+
+#if defined(_WIN32) || defined(_WIN64)
+#include "wingetopt.h"
+
+static volatile BOOL user_break;
+static BOOL WINAPI ConsoleBreakHandlerRoutine(DWORD dwCtrlType) {
+ (void)dwCtrlType;
+ user_break = true;
+ return true;
+}
+
+#else /* WINDOWS */
+
+static volatile sig_atomic_t user_break;
+static void signal_handler(int sig) {
+ (void)sig;
+ user_break = 1;
+}
+
+#endif /* !WINDOWS */
+
+static void prstat(MDBX_stat *ms) {
+ printf(" Pagesize: %u\n", ms->ms_psize);
+ printf(" Tree depth: %u\n", ms->ms_depth);
+ printf(" Branch pages: %" PRIu64 "\n", ms->ms_branch_pages);
+ printf(" Leaf pages: %" PRIu64 "\n", ms->ms_leaf_pages);
+ printf(" Overflow pages: %" PRIu64 "\n", ms->ms_overflow_pages);
+ printf(" Entries: %" PRIu64 "\n", ms->ms_entries);
+}
+
+static void usage(char *prog) {
+ fprintf(stderr,
+ "usage: %s [-V] [-n] [-e] [-r[r]] [-f[f[f]]] [-a|-s subdb] dbpath\n",
+ prog);
+ exit(EXIT_FAILURE);
+}
+
+static int reader_list_func(void *ctx, int num, int slot, mdbx_pid_t pid,
+ mdbx_tid_t thread, uint64_t txnid, uint64_t lag,
+ size_t bytes_used, size_t bytes_retained) {
+ (void)ctx;
+ if (num == 1)
+ printf("Reader Table Status\n"
+ " #\tslot\t%6s %*s %20s %10s %13s %13s\n",
+ "pid", (int)sizeof(size_t) * 2, "thread", "txnid", "lag", "used",
+ "retained");
+
+ printf(" %3d)\t[%d]\t%6" PRIdSIZE " %*" PRIxSIZE, num, slot, (size_t)pid,
+ (int)sizeof(size_t) * 2, (size_t)thread);
+ if (txnid)
+ printf(" %20" PRIu64 " %10" PRIu64 " %12.1fM %12.1fM\n", txnid, lag,
+ bytes_used / 1048576.0, bytes_retained / 1048576.0);
+ else
+ printf(" %20s %10s %13s %13s\n", "-", "0", "0", "0");
+
+ return user_break ? MDBX_RESULT_TRUE : MDBX_RESULT_FALSE;
+}
+
+int main(int argc, char *argv[]) {
+ int o, rc;
+ MDBX_env *env;
+ MDBX_txn *txn;
+ MDBX_dbi dbi;
+ MDBX_stat mst;
+ MDBX_envinfo mei;
+ char *prog = argv[0];
+ char *envname;
+ char *subname = NULL;
+ int alldbs = 0, envinfo = 0, envflags = 0, freinfo = 0, rdrinfo = 0;
+
+ if (argc < 2)
+ usage(prog);
+
+ /* -a: print stat of main DB and all subDBs
+ * -s: print stat of only the named subDB
+ * -e: print env info
+ * -f: print freelist info
+ * -r: print reader info
+ * -n: use NOSUBDIR flag on env_open
+ * -V: print version and exit
+ * (default) print stat of only the main DB
+ */
+ while ((o = getopt(argc, argv, "Vaefnrs:")) != EOF) {
+ switch (o) {
+ case 'V':
+ printf("mdbx_stat version %d.%d.%d.%d\n"
+ " - source: %s %s, commit %s, tree %s\n"
+ " - anchor: %s\n"
+ " - build: %s for %s by %s\n"
+ " - flags: %s\n"
+ " - options: %s\n",
+ mdbx_version.major, mdbx_version.minor, mdbx_version.release,
+ mdbx_version.revision, mdbx_version.git.describe,
+ mdbx_version.git.datetime, mdbx_version.git.commit,
+ mdbx_version.git.tree, mdbx_sourcery_anchor, mdbx_build.datetime,
+ mdbx_build.target, mdbx_build.compiler, mdbx_build.flags,
+ mdbx_build.options);
+ return EXIT_SUCCESS;
+ case 'a':
+ if (subname)
+ usage(prog);
+ alldbs++;
+ break;
+ case 'e':
+ envinfo++;
+ break;
+ case 'f':
+ freinfo++;
+ break;
+ case 'n':
+ envflags |= MDBX_NOSUBDIR;
+ break;
+ case 'r':
+ rdrinfo++;
+ break;
+ case 's':
+ if (alldbs)
+ usage(prog);
+ subname = optarg;
+ break;
+ default:
+ usage(prog);
+ }
+ }
+
+ if (optind != argc - 1)
+ usage(prog);
+
+#if defined(_WIN32) || defined(_WIN64)
+ SetConsoleCtrlHandler(ConsoleBreakHandlerRoutine, true);
+#else
+#ifdef SIGPIPE
+ signal(SIGPIPE, signal_handler);
+#endif
+#ifdef SIGHUP
+ signal(SIGHUP, signal_handler);
+#endif
+ signal(SIGINT, signal_handler);
+ signal(SIGTERM, signal_handler);
+#endif /* !WINDOWS */
+
+ envname = argv[optind];
+ envname = argv[optind];
+ printf("mdbx_stat %s (%s, T-%s)\nRunning for %s...\n",
+ mdbx_version.git.describe, mdbx_version.git.datetime,
+ mdbx_version.git.tree, envname);
+ fflush(NULL);
+
+ rc = mdbx_env_create(&env);
+ if (rc) {
+ fprintf(stderr, "mdbx_env_create failed, error %d %s\n", rc,
+ mdbx_strerror(rc));
+ return EXIT_FAILURE;
+ }
+
+ if (alldbs || subname)
+ mdbx_env_set_maxdbs(env, 4);
+
+ rc = mdbx_env_open(env, envname, envflags | MDBX_RDONLY, 0664);
+ if (rc) {
+ fprintf(stderr, "mdbx_env_open failed, error %d %s\n", rc,
+ mdbx_strerror(rc));
+ goto env_close;
+ }
+
+ if (envinfo || freinfo) {
+ (void)mdbx_env_info(env, &mei, sizeof(mei));
+ } else {
+ /* LY: zap warnings from gcc */
+ memset(&mei, 0, sizeof(mei));
+ }
+
+ if (envinfo) {
+ (void)mdbx_env_stat(env, &mst, sizeof(mst));
+ printf("Environment Info\n");
+ printf(" Pagesize: %u\n", mst.ms_psize);
+ if (mei.mi_geo.lower != mei.mi_geo.upper) {
+ printf(" Dynamic datafile: %" PRIu64 "..%" PRIu64 " bytes (+%" PRIu64
+ "/-%" PRIu64 "), %" PRIu64 "..%" PRIu64 " pages (+%" PRIu64
+ "/-%" PRIu64 ")\n",
+ mei.mi_geo.lower, mei.mi_geo.upper, mei.mi_geo.grow,
+ mei.mi_geo.shrink, mei.mi_geo.lower / mst.ms_psize,
+ mei.mi_geo.upper / mst.ms_psize, mei.mi_geo.grow / mst.ms_psize,
+ mei.mi_geo.shrink / mst.ms_psize);
+ printf(" Current datafile: %" PRIu64 " bytes, %" PRIu64 " pages\n",
+ mei.mi_geo.current, mei.mi_geo.current / mst.ms_psize);
+ } else {
+ printf(" Fixed datafile: %" PRIu64 " bytes, %" PRIu64 " pages\n",
+ mei.mi_geo.current, mei.mi_geo.current / mst.ms_psize);
+ }
+ printf(" Current mapsize: %" PRIu64 " bytes, %" PRIu64 " pages \n",
+ mei.mi_mapsize, mei.mi_mapsize / mst.ms_psize);
+ printf(" Number of pages used: %" PRIu64 "\n", mei.mi_last_pgno + 1);
+ printf(" Last transaction ID: %" PRIu64 "\n", mei.mi_recent_txnid);
+ printf(" Tail transaction ID: %" PRIu64 " (%" PRIi64 ")\n",
+ mei.mi_latter_reader_txnid,
+ mei.mi_latter_reader_txnid - mei.mi_recent_txnid);
+ printf(" Max readers: %u\n", mei.mi_maxreaders);
+ printf(" Number of readers used: %u\n", mei.mi_numreaders);
+ } else {
+ /* LY: zap warnings from gcc */
+ memset(&mst, 0, sizeof(mst));
+ }
+
+ if (rdrinfo) {
+ rc = mdbx_reader_list(env, reader_list_func, nullptr);
+ if (rc == MDBX_RESULT_TRUE)
+ printf("Reader Table is empty\n");
+ else if (rc == MDBX_SUCCESS && rdrinfo > 1) {
+ int dead;
+ rc = mdbx_reader_check(env, &dead);
+ if (rc == MDBX_RESULT_TRUE) {
+ printf(" %d stale readers cleared.\n", dead);
+ rc = mdbx_reader_list(env, reader_list_func, nullptr);
+ if (rc == MDBX_RESULT_TRUE)
+ printf(" Now Reader Table is empty\n");
+ } else
+ printf(" No stale readers.\n");
+ }
+ if (MDBX_IS_ERROR(rc)) {
+ fprintf(stderr, "mdbx_txn_begin failed, error %d %s\n", rc,
+ mdbx_strerror(rc));
+ goto env_close;
+ }
+ if (!(subname || alldbs || freinfo))
+ goto env_close;
+ }
+
+ rc = mdbx_txn_begin(env, NULL, MDBX_RDONLY, &txn);
+ if (rc) {
+ fprintf(stderr, "mdbx_txn_begin failed, error %d %s\n", rc,
+ mdbx_strerror(rc));
+ goto env_close;
+ }
+
+ if (freinfo) {
+ MDBX_cursor *cursor;
+ MDBX_val key, data;
+ pgno_t pages = 0, *iptr;
+ pgno_t reclaimable = 0;
+
+ printf("Freelist Status\n");
+ dbi = 0;
+ rc = mdbx_cursor_open(txn, dbi, &cursor);
+ if (rc) {
+ fprintf(stderr, "mdbx_cursor_open failed, error %d %s\n", rc,
+ mdbx_strerror(rc));
+ goto txn_abort;
+ }
+ rc = mdbx_dbi_stat(txn, dbi, &mst, sizeof(mst));
+ if (rc) {
+ fprintf(stderr, "mdbx_dbi_stat failed, error %d %s\n", rc,
+ mdbx_strerror(rc));
+ goto txn_abort;
+ }
+ prstat(&mst);
+ while ((rc = mdbx_cursor_get(cursor, &key, &data, MDBX_NEXT)) ==
+ MDBX_SUCCESS) {
+ if (user_break) {
+ rc = MDBX_EINTR;
+ break;
+ }
+ iptr = data.iov_base;
+ const pgno_t number = *iptr++;
+
+ pages += number;
+ if (envinfo && mei.mi_latter_reader_txnid > *(size_t *)key.iov_base)
+ reclaimable += number;
+
+ if (freinfo > 1) {
+ char *bad = "";
+ pgno_t prev =
+ MDBX_PNL_ASCENDING ? NUM_METAS - 1 : (pgno_t)mei.mi_last_pgno + 1;
+ pgno_t span = 1;
+ for (unsigned i = 0; i < number; ++i) {
+ pgno_t pg = iptr[i];
+ if (MDBX_PNL_DISORDERED(prev, pg))
+ bad = " [bad sequence]";
+ prev = pg;
+ while (i + span < number &&
+ iptr[i + span] == (MDBX_PNL_ASCENDING ? pgno_add(pg, span)
+ : pgno_sub(pg, span)))
+ ++span;
+ }
+ printf(" Transaction %" PRIaTXN ", %" PRIaPGNO
+ " pages, maxspan %" PRIaPGNO "%s\n",
+ *(txnid_t *)key.iov_base, number, span, bad);
+ if (freinfo > 2) {
+ for (unsigned i = 0; i < number; i += span) {
+ const pgno_t pg = iptr[i];
+ for (span = 1;
+ i + span < number &&
+ iptr[i + span] == (MDBX_PNL_ASCENDING ? pgno_add(pg, span)
+ : pgno_sub(pg, span));
+ ++span)
+ ;
+ if (span > 1)
+ printf(" %9" PRIaPGNO "[%" PRIaPGNO "]\n", pg, span);
+ else
+ printf(" %9" PRIaPGNO "\n", pg);
+ }
+ }
+ }
+ }
+ mdbx_cursor_close(cursor);
+
+ switch (rc) {
+ case MDBX_SUCCESS:
+ case MDBX_NOTFOUND:
+ break;
+ case MDBX_EINTR:
+ fprintf(stderr, "Interrupted by signal/user\n");
+ goto txn_abort;
+ default:
+ fprintf(stderr, "mdbx_cursor_get failed, error %d %s\n", rc,
+ mdbx_strerror(rc));
+ goto txn_abort;
+ }
+
+ if (envinfo) {
+ uint64_t value = mei.mi_mapsize / mst.ms_psize;
+ double percent = value / 100.0;
+ printf("Page Allocation Info\n");
+ printf(" Max pages: %" PRIu64 " 100%%\n", value);
+
+ value = mei.mi_last_pgno + 1;
+ printf(" Pages used: %" PRIu64 " %.1f%%\n", value, value / percent);
+
+ value = mei.mi_mapsize / mst.ms_psize - (mei.mi_last_pgno + 1);
+ printf(" Remained: %" PRIu64 " %.1f%%\n", value, value / percent);
+
+ value = mei.mi_last_pgno + 1 - pages;
+ printf(" Used now: %" PRIu64 " %.1f%%\n", value, value / percent);
+
+ value = pages;
+ printf(" Unallocated: %" PRIu64 " %.1f%%\n", value, value / percent);
+
+ value = pages - reclaimable;
+ printf(" Detained: %" PRIu64 " %.1f%%\n", value, value / percent);
+
+ value = reclaimable;
+ printf(" Reclaimable: %" PRIu64 " %.1f%%\n", value, value / percent);
+
+ value =
+ mei.mi_mapsize / mst.ms_psize - (mei.mi_last_pgno + 1) + reclaimable;
+ printf(" Available: %" PRIu64 " %.1f%%\n", value, value / percent);
+ } else
+ printf(" Free pages: %" PRIaPGNO "\n", pages);
+ }
+
+ rc = mdbx_dbi_open(txn, subname, 0, &dbi);
+ if (rc) {
+ fprintf(stderr, "mdbx_open failed, error %d %s\n", rc, mdbx_strerror(rc));
+ goto txn_abort;
+ }
+
+ rc = mdbx_dbi_stat(txn, dbi, &mst, sizeof(mst));
+ if (rc) {
+ fprintf(stderr, "mdbx_dbi_stat failed, error %d %s\n", rc,
+ mdbx_strerror(rc));
+ goto txn_abort;
+ }
+ printf("Status of %s\n", subname ? subname : "Main DB");
+ prstat(&mst);
+
+ if (alldbs) {
+ MDBX_cursor *cursor;
+ MDBX_val key;
+
+ rc = mdbx_cursor_open(txn, dbi, &cursor);
+ if (rc) {
+ fprintf(stderr, "mdbx_cursor_open failed, error %d %s\n", rc,
+ mdbx_strerror(rc));
+ goto txn_abort;
+ }
+ while ((rc = mdbx_cursor_get(cursor, &key, NULL, MDBX_NEXT_NODUP)) == 0) {
+ char *str;
+ MDBX_dbi db2;
+ if (memchr(key.iov_base, '\0', key.iov_len))
+ continue;
+ str = mdbx_malloc(key.iov_len + 1);
+ memcpy(str, key.iov_base, key.iov_len);
+ str[key.iov_len] = '\0';
+ rc = mdbx_dbi_open(txn, str, 0, &db2);
+ if (rc == MDBX_SUCCESS)
+ printf("Status of %s\n", str);
+ mdbx_free(str);
+ if (rc)
+ continue;
+ rc = mdbx_dbi_stat(txn, db2, &mst, sizeof(mst));
+ if (rc) {
+ fprintf(stderr, "mdbx_dbi_stat failed, error %d %s\n", rc,
+ mdbx_strerror(rc));
+ goto txn_abort;
+ }
+ prstat(&mst);
+ mdbx_dbi_close(env, db2);
+ }
+ mdbx_cursor_close(cursor);
+ }
+
+ if (rc == MDBX_NOTFOUND)
+ rc = MDBX_SUCCESS;
+
+ mdbx_dbi_close(env, dbi);
+txn_abort:
+ mdbx_txn_abort(txn);
+env_close:
+ mdbx_env_close(env);
+
+ return rc ? EXIT_FAILURE : EXIT_SUCCESS;
+}
diff --git a/contrib/db/libmdbx/src/tools/wingetopt.c b/contrib/db/libmdbx/src/tools/wingetopt.c
new file mode 100644
index 00000000..7feb223f
--- /dev/null
+++ b/contrib/db/libmdbx/src/tools/wingetopt.c
@@ -0,0 +1,95 @@
+/*
+ * POSIX getopt for Windows
+ *
+ * AT&T Public License
+ *
+ * Code given out at the 1985 UNIFORUM conference in Dallas.
+ */
+
+/*----------------------------------------------------------------------------*/
+/* Microsoft compiler generates a lot of warning for self includes... */
+
+#ifdef _MSC_VER
+#pragma warning(push, 1)
+#pragma warning(disable : 4548) /* expression before comma has no effect; \
+ expected expression with side - effect */
+#pragma warning(disable : 4530) /* C++ exception handler used, but unwind \
+ * semantics are not enabled. Specify /EHsc */
+#pragma warning(disable : 4577) /* 'noexcept' used with no exception handling \
+ * mode specified; termination on exception is \
+ * not guaranteed. Specify /EHsc */
+#if !defined(_CRT_SECURE_NO_WARNINGS)
+#define _CRT_SECURE_NO_WARNINGS
+#endif
+#endif /* _MSC_VER (warnings) */
+
+#include "wingetopt.h"
+#include
+#include
+
+#ifdef _MSC_VER
+#pragma warning(pop)
+#endif
+/*----------------------------------------------------------------------------*/
+
+#ifndef NULL
+#define NULL 0
+#endif
+
+#ifndef EOF
+#define EOF (-1)
+#endif
+
+#define ERR(s, c) \
+ if (opterr) { \
+ fputs(argv[0], stderr); \
+ fputs(s, stderr); \
+ fputc(c, stderr); \
+ }
+
+int opterr = 1;
+int optind = 1;
+int optopt;
+char *optarg;
+
+int getopt(int argc, char *const argv[], const char *opts) {
+ static int sp = 1;
+ int c;
+ const char *cp;
+
+ if (sp == 1) {
+ if (optind >= argc || argv[optind][0] != '-' || argv[optind][1] == '\0')
+ return EOF;
+ else if (strcmp(argv[optind], "--") == 0) {
+ optind++;
+ return EOF;
+ }
+ }
+ optopt = c = argv[optind][sp];
+ if (c == ':' || (cp = strchr(opts, c)) == NULL) {
+ ERR(": illegal option -- ", c);
+ if (argv[optind][++sp] == '\0') {
+ optind++;
+ sp = 1;
+ }
+ return '?';
+ }
+ if (*++cp == ':') {
+ if (argv[optind][sp + 1] != '\0')
+ optarg = &argv[optind++][sp + 1];
+ else if (++optind >= argc) {
+ ERR(": option requires an argument -- ", c);
+ sp = 1;
+ return '?';
+ } else
+ optarg = argv[optind++];
+ sp = 1;
+ } else {
+ if (argv[optind][++sp] == '\0') {
+ sp = 1;
+ optind++;
+ }
+ optarg = NULL;
+ }
+ return c;
+}
diff --git a/contrib/db/libmdbx/src/tools/wingetopt.h b/contrib/db/libmdbx/src/tools/wingetopt.h
new file mode 100644
index 00000000..d328e38c
--- /dev/null
+++ b/contrib/db/libmdbx/src/tools/wingetopt.h
@@ -0,0 +1,30 @@
+/*
+ * POSIX getopt for Windows
+ *
+ * AT&T Public License
+ *
+ * Code given out at the 1985 UNIFORUM conference in Dallas.
+ */
+
+#ifndef _WINGETOPT_H_
+#define _WINGETOPT_H_
+
+/* Bit of madness for Windows console */
+#define mdbx_strerror mdbx_strerror_ANSI2OEM
+#define mdbx_strerror_r mdbx_strerror_r_ANSI2OEM
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+extern int opterr;
+extern int optind;
+extern int optopt;
+extern char *optarg;
+int getopt(int argc, char *const argv[], const char *optstring);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* _GETOPT_H_ */
diff --git a/contrib/db/libmdbx/test/CMakeLists.txt b/contrib/db/libmdbx/test/CMakeLists.txt
new file mode 100644
index 00000000..0cc22182
--- /dev/null
+++ b/contrib/db/libmdbx/test/CMakeLists.txt
@@ -0,0 +1,53 @@
+if(${CMAKE_SYSTEM_NAME} STREQUAL "Windows")
+ set(TEST_OSAL windows)
+else()
+ set(TEST_OSAL unix)
+endif()
+
+add_executable(mdbx_test
+ base.h
+ cases.cc
+ chrono.cc
+ chrono.h
+ config.cc
+ config.h
+ copy.cc
+ dead.cc
+ hill.cc
+ jitter.cc
+ keygen.cc
+ keygen.h
+ log.cc
+ log.h
+ main.cc
+ osal.h
+ osal-${TEST_OSAL}.cc
+ test.cc
+ test.h
+ try.cc
+ utils.cc
+ utils.h
+ append.cc
+ ttl.cc
+ nested.cc
+ )
+
+set_target_properties(mdbx_test PROPERTIES
+ INTERPROCEDURAL_OPTIMIZATION $
+ CXX_STANDARD 17 CXX_STANDARD_REQUIRED ON)
+
+if(CC_HAS_FASTMATH)
+ target_compile_options(mdbx_test PRIVATE "-ffast-math")
+endif()
+if(CC_HAS_VISIBILITY AND (LTO_ENABLED OR INTERPROCEDURAL_OPTIMIZATION))
+ set_target_properties(mdbx_test PROPERTIES LINK_FLAGS "-fvisibility=hidden")
+endif()
+
+target_link_libraries(mdbx_test mdbx ${LIB_MATH} ${CMAKE_THREAD_LIBS_INIT})
+if(${CMAKE_SYSTEM_NAME} STREQUAL "Windows")
+ target_link_libraries(mdbx_test winmm.lib)
+endif()
+
+if(UNIX AND NOT SUBPROJECT)
+ add_subdirectory(pcrf)
+endif()
diff --git a/contrib/db/libmdbx/test/append.cc b/contrib/db/libmdbx/test/append.cc
new file mode 100644
index 00000000..9f567c7e
--- /dev/null
+++ b/contrib/db/libmdbx/test/append.cc
@@ -0,0 +1,164 @@
+/*
+ * Copyright 2017-2019 Leonid Yuriev
+ * and other libmdbx authors: please see AUTHORS file.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted only as authorized by the OpenLDAP
+ * Public License.
+ *
+ * A copy of this license is available in the file LICENSE in the
+ * top-level directory of the distribution or, alternatively, at
+ * .
+ */
+
+#include "test.h"
+
+bool testcase_append::run() {
+ int err = db_open__begin__table_create_open_clean(dbi);
+ if (unlikely(err != MDBX_SUCCESS)) {
+ log_notice("append: bailout-prepare due '%s'", mdbx_strerror(err));
+ return true;
+ }
+
+ keyvalue_maker.setup(config.params, config.actor_id, 0 /* thread_number */);
+ /* LY: тест наполнения таблиц в append-режиме,
+ * при котором записи добавляются строго в конец (в порядке сортировки) */
+ const unsigned flags = (config.params.table_flags & MDBX_DUPSORT)
+ ? MDBX_APPEND | MDBX_APPENDDUP
+ : MDBX_APPEND;
+ keyvalue_maker.make_ordered();
+
+ key = keygen::alloc(config.params.keylen_max);
+ data = keygen::alloc(config.params.datalen_max);
+ keygen::buffer last_key = keygen::alloc(config.params.keylen_max);
+ keygen::buffer last_data = keygen::alloc(config.params.datalen_max);
+ last_key->value.iov_base = last_key->bytes;
+ last_key->value.iov_len = 0;
+ last_data->value.iov_base = last_data->bytes;
+ last_data->value.iov_len = 0;
+
+ simple_checksum inserted_checksum;
+ uint64_t inserted_number = 0;
+ uint64_t serial_count = 0;
+
+ unsigned txn_nops = 0;
+ uint64_t commited_inserted_number = inserted_number;
+ simple_checksum commited_inserted_checksum = inserted_checksum;
+ while (should_continue()) {
+ const keygen::serial_t serial = serial_count;
+ if (!keyvalue_maker.increment(serial_count, 1)) {
+ // дошли до границы пространства ключей
+ break;
+ }
+
+ log_trace("append: append-a %" PRIu64, serial);
+ generate_pair(serial, key, data);
+ int cmp = inserted_number ? mdbx_cmp(txn_guard.get(), dbi, &key->value,
+ &last_key->value)
+ : 1;
+ if (cmp == 0 && (config.params.table_flags & MDBX_DUPSORT))
+ cmp = mdbx_dcmp(txn_guard.get(), dbi, &data->value, &last_data->value);
+
+ err = mdbx_put(txn_guard.get(), dbi, &key->value, &data->value, flags);
+ if (err == MDBX_MAP_FULL && config.params.ignore_dbfull) {
+ log_notice("append: bailout-insert due '%s'", mdbx_strerror(err));
+ txn_end(true);
+ inserted_number = commited_inserted_number;
+ inserted_checksum = commited_inserted_checksum;
+ break;
+ }
+
+ if (cmp > 0) {
+ if (unlikely(err != MDBX_SUCCESS))
+ failure_perror("mdbx_put(appenda-a)", err);
+
+ memcpy(last_key->value.iov_base, key->value.iov_base,
+ last_key->value.iov_len = key->value.iov_len);
+ memcpy(last_data->value.iov_base, data->value.iov_base,
+ last_data->value.iov_len = data->value.iov_len);
+ ++inserted_number;
+ inserted_checksum.push((uint32_t)inserted_number, key->value);
+ inserted_checksum.push(10639, data->value);
+ } else {
+ if (unlikely(err != MDBX_EKEYMISMATCH))
+ failure_perror("mdbx_put(appenda-a) != MDBX_EKEYMISMATCH", err);
+ }
+
+ if (++txn_nops >= config.params.batch_write) {
+ err = breakable_restart();
+ if (unlikely(err != MDBX_SUCCESS)) {
+ log_notice("append: bailout-commit due '%s'", mdbx_strerror(err));
+ inserted_number = commited_inserted_number;
+ inserted_checksum = commited_inserted_checksum;
+ break;
+ }
+ commited_inserted_number = inserted_number;
+ commited_inserted_checksum = inserted_checksum;
+ txn_nops = 0;
+ }
+
+ report(1);
+ }
+
+ if (txn_guard) {
+ err = breakable_commit();
+ if (unlikely(err != MDBX_SUCCESS)) {
+ log_notice("append: bailout-commit due '%s'", mdbx_strerror(err));
+ inserted_number = commited_inserted_number;
+ inserted_checksum = commited_inserted_checksum;
+ }
+ }
+ //----------------------------------------------------------------------------
+ txn_begin(true);
+ cursor_open(dbi);
+
+ MDBX_val check_key, check_data;
+ err =
+ mdbx_cursor_get(cursor_guard.get(), &check_key, &check_data, MDBX_FIRST);
+ if (likely(inserted_number)) {
+ if (unlikely(err != MDBX_SUCCESS))
+ failure_perror("mdbx_cursor_get(MDBX_FIRST)", err);
+ }
+
+ simple_checksum read_checksum;
+ uint64_t read_count = 0;
+ while (err == MDBX_SUCCESS) {
+ ++read_count;
+ read_checksum.push((uint32_t)read_count, check_key);
+ read_checksum.push(10639, check_data);
+
+ err =
+ mdbx_cursor_get(cursor_guard.get(), &check_key, &check_data, MDBX_NEXT);
+ }
+
+ if (unlikely(err != MDBX_NOTFOUND))
+ failure_perror("mdbx_cursor_get(MDBX_NEXT) != EOF", err);
+
+ if (unlikely(read_count != inserted_number))
+ failure("read_count(%" PRIu64 ") != inserted_number(%" PRIu64 ")",
+ read_count, inserted_number);
+
+ if (unlikely(read_checksum.value != inserted_checksum.value))
+ failure("read_checksum(0x%016" PRIu64 ") "
+ "!= inserted_checksum(0x%016" PRIu64 ")",
+ read_checksum.value, inserted_checksum.value);
+
+ cursor_close();
+ txn_end(true);
+ //----------------------------------------------------------------------------
+
+ if (dbi) {
+ if (config.params.drop_table && !mode_readonly()) {
+ txn_begin(false);
+ db_table_drop(dbi);
+ err = breakable_commit();
+ if (unlikely(err != MDBX_SUCCESS)) {
+ log_notice("append: bailout-clean due '%s'", mdbx_strerror(err));
+ return true;
+ }
+ } else
+ db_table_close(dbi);
+ }
+ return true;
+}
diff --git a/contrib/db/libmdbx/test/base.h b/contrib/db/libmdbx/test/base.h
new file mode 100644
index 00000000..04942818
--- /dev/null
+++ b/contrib/db/libmdbx/test/base.h
@@ -0,0 +1,116 @@
+/*
+ * Copyright 2017-2019 Leonid Yuriev
+ * and other libmdbx authors: please see AUTHORS file.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted only as authorized by the OpenLDAP
+ * Public License.
+ *
+ * A copy of this license is available in the file LICENSE in the
+ * top-level directory of the distribution or, alternatively, at
+ * .
+ */
+
+#pragma once
+
+#ifndef NOMINMAX
+#define NOMINMAX
+#endif
+
+#if defined(_WIN32) || defined(_WIN64) || defined(_WINDOWS)
+#ifdef _MSC_VER
+#define _CRT_SECURE_NO_WARNINGS
+#pragma warning(push, 1)
+#pragma warning(disable : 4548) /* expression before comma has no effect; \
+ expected expression with side - effect */
+#pragma warning(disable : 4530) /* C++ exception handler used, but unwind \
+ semantics are not enabled. Specify /EHsc */
+#pragma warning(disable : 4577) /* 'noexcept' used with no exception handling \
+ mode specified; termination on exception \
+ is not guaranteed. Specify /EHsc */
+#endif /* _MSC_VER (warnings) */
+
+/* If you wish to build your application for a previous Windows platform,
+ * include WinSDKVer.h and set the _WIN32_WINNT macro to the platform you
+ * wish to support before including SDKDDKVer.h.
+ *
+ * TODO: #define _WIN32_WINNT WIN32_MUSTDIE */
+#include
+#endif /* WINDOWS */
+
+#ifdef __APPLE__
+#define _DARWIN_C_SOURCE
+#endif
+
+#include
+#include
+#include
+#include
+#include
+#include
+
+#if defined(_WIN32) || defined(_WIN64) || defined(_WINDOWS)
+#include
+#else
+#include
+#include
+#include
+#include
+#include
+#include
+#endif
+
+#ifdef _BSD_SOURCE
+#include
+#endif
+
+#include
+#include
+#include // for PRId64, PRIu64
+#include
+#include
+#include
+#include