github.com/moontrade/mdbx-go@v0.4.0/ChangeLog.md (about) 1 ChangeLog 2 --------- 3 4 ## v0.11.7 at 2022-04-22 5 6 The stable risen release after the Github's intentional malicious disaster. 7 8 #### We have migrated to a reliable trusted infrastructure 9 The origin for now is at [GitFlic](https://gitflic.ru/project/erthink/libmdbx) 10 since on 2022-04-15 the Github administration, without any warning nor 11 explanation, deleted _libmdbx_ along with a lot of other projects, 12 simultaneously blocking access for many developers. 13 For the same reason ~~Github~~ is blacklisted forever. 14 15 GitFlic already support Russian and English languages, plan to support more, 16 including 和 中文. You are welcome! 17 18 New: 19 20 - Added the `tools-static` make target to build statically linked MDBX tools. 21 - Support for Microsoft Visual Studio 2022. 22 - Support build by MinGW' make from command line without CMake. 23 - Added `mdbx::filesystem` C++ API namespace that corresponds to `std::filesystem` or `std::experimental::filesystem`. 24 - Created [website](https://libmdbx.website.yandexcloud.net/) for online auto-generated documentation. 25 - Used `https://web.archive.org/web/20220414235959/https://github.com/erthink/` for dead (or temporarily lost) resources deleted by ~~Github~~. 26 - Added `--loglevel=` command-line option to the `mdbx_test` tool. 27 - Added few fast smoke-like tests into CMake builds. 28 29 Fixes: 30 31 - Fixed a race between starting a transaction and creating a DBI descriptor that could lead to `SIGSEGV` in the cursor tracking code. 32 - Clarified description of `MDBX_EPERM` error returned from `mdbx_env_set_geometry()`. 33 - Fixed non-promoting the parent transaction to be dirty in case the undo of the geometry update failed during abortion of a nested transaction. 34 - Resolved linking issues with `libstdc++fs`/`libc++fs`/`libc++experimental` for C++ `std::filesystem` or `std::experimental::filesystem` for legacy compilers. 35 - Added workaround for GNU Make 3.81 and earlier. 36 - Added workaround for Elbrus/LCC 1.25 compiler bug of class inline `static constexpr` member field. 37 - [Fixed](https://github.com/ledgerwatch/erigon/issues/3874) minor assertion regression (only debug builds were affected). 38 - Fixed detection of `C++20` concepts accessibility. 39 - Fixed detection of Clang's LTO availability for Android. 40 - Fixed build for ARM/ARM64 by MSVC. 41 - Fixed non-x86 Windows builds with `MDBX_WITHOUT_MSVC_CRT=ON` and `MDBX_BUILD_SHARED_LIBRARY=ON`. 42 43 Minors: 44 45 - Resolve minor MSVC warnings: avoid `/INCREMENTAL[:YES]` with `/LTCG`, `/W4` with `/W3`, the `C5105` warning. 46 - Switched to using `MDBX_EPERM` instead of `MDBX_RESULT_TRUE' to indicate that the geometry cannot be updated. 47 - Added `NULL` checking during memory allocation inside `mdbx_chk`. 48 - Resolved all warnings from MinGW while used without CMake. 49 - Added inheretable `target_include_directories()` to `CMakeLists.txt` for easy integration. 50 - Added build-time checks and paranoid runtime assertions for the `off_t` arguments of `fcntl()` which are used for locking. 51 - Added `-Wno-lto-type-mismatch` to avoid false-positive warnings from old GCC during LTO-enabled builds. 52 - Added checking for TID (system thread id) to avoid hang on 32-bit Bionic/Android within `pthread_mutex_lock()`. 53 - Reworked `MDBX_BUILD_TARGET` of CMake builds. 54 - Added `CMAKE_HOST_ARCH` and `CMAKE_HOST_CAN_RUN_EXECUTABLES_BUILT_FOR_TARGET`. 55 56 57 ------------------------------------------------------------------------------- 58 59 60 ## v0.11.6 at 2022-03-24 61 62 The stable release with the complete workaround for an incoherence flaw of Linux unified page/buffer cache. 63 Nonetheless the cause for this trouble may be an issue of Intel CPU cache/MESI. 64 See [issue#269](https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/issues/269) for more information. 65 66 Acknowledgements: 67 68 - [David Bouyssié](https://github.com/david-bouyssie) for [Scala bindings](https://github.com/david-bouyssie/mdbx4s). 69 - [Michelangelo Riccobene](https://github.com/mriccobene) for reporting and testing. 70 71 Fixes: 72 73 - [Added complete workaround](https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/issues/269) for an incoherence flaw of Linux unified page/buffer cache. 74 - [Fixed](https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/issues/272) cursor reusing for read-only transactions. 75 - Fixed copy&paste typo inside `mdbx::cursor::find_multivalue()`. 76 77 Minors: 78 79 - Minor refine C++ API for convenience. 80 - Minor internals refines. 81 - Added `lib-static` and `lib-shared` targets for make. 82 - Added minor workaround for AppleClang 13.3 bug. 83 - Clarified error messages of a signature/version mismatch. 84 85 86 ## v0.11.5 at 2022-02-23 87 88 The release with the temporary hotfix for a flaw of Linux unified page/buffer cache. 89 See [issue#269](https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/issues/269) for more information. 90 91 Acknowledgements: 92 93 - [Simon Leier](https://github.com/leisim) for reporting and testing. 94 - [Kai Wetlesen](https://github.com/kaiwetlesen) for [RPMs](http://copr.fedorainfracloud.org/coprs/kwetlesen/libmdbx/). 95 - [Tullio Canepa](https://github.com/canepat) for reporting C++ API issue and contributing. 96 97 Fixes: 98 99 - [Added hotfix](https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/issues/269) for a flaw of Linux unified page/buffer cache. 100 - [Fixed/Reworked](https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/pull/270) move-assignment operators for "managed" classes of C++ API. 101 - Fixed potential `SIGSEGV` while open DB with overrided non-default page size. 102 - [Made](https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/issues/267) `mdbx_env_open()` idempotence in failure cases. 103 - Refined/Fixed pages reservation inside `mdbx_update_gc()` to avoid non-reclamation in a rare cases. 104 - Fixed typo in a retained space calculation for the hsr-callback. 105 106 Minors: 107 108 - Reworked functions for meta-pages, split-off non-volatile. 109 - Disentangled C11-atomic fences/barriers and pure-functions (with `__attribute__((__pure__))`) to avoid compiler misoptimization. 110 - Fixed hypotetic unaligned access to 64-bit dwords on ARM with `__ARM_FEATURE_UNALIGNED` defined. 111 - Reasonable paranoia that makes clarity for code readers. 112 - Minor fixes Doxygen references, comments, descriptions, etc. 113 114 115 ## v0.11.4 at 2022-02-02 116 117 The stable release with fixes for large and huge databases sized of 4..128 TiB. 118 119 Acknowledgements: 120 121 - [Ledgerwatch](https://github.com/ledgerwatch), [Binance](https://github.com/binance-chain) and [Positive Technologies](https://www.ptsecurity.com/) teams for reporting, assistance in investigation and testing. 122 - [Alex Sharov](https://github.com/AskAlexSharov) for reporting, testing and provide resources for remote debugging/investigation. 123 - [Kris Zyp](https://github.com/kriszyp) for [Deno](https://deno.land/) support. 124 125 New features, extensions and improvements: 126 127 - Added treating the `UINT64_MAX` value as maximum for given option inside `mdbx_env_set_option()`. 128 - Added `to_hex/to_base58/to_base64::output(std::ostream&)` overloads without using temporary string objects as buffers. 129 - Added `--geometry-jitter=YES|no` option to the test framework. 130 - Added support for [Deno](https://deno.land/) support by [Kris Zyp](https://github.com/kriszyp). 131 132 Fixes: 133 134 - Fixed handling `MDBX_opt_rp_augment_limit` for GC's records from huge transactions (Erigon/Akula/Ethereum). 135 - [Fixed](https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/issues/258) build on Android (avoid including `sys/sem.h`). 136 - [Fixed](https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/pull/261) missing copy assignment operator for `mdbx::move_result`. 137 - Fixed missing `&` for `std::ostream &operator<<()` overloads. 138 - Fixed unexpected `EXDEV` (Cross-device link) error from `mdbx_env_copy()`. 139 - Fixed base64 encoding/decoding bugs in auxillary C++ API. 140 - Fixed overflow of `pgno_t` during checking PNL on 64-bit platforms. 141 - [Fixed](https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/issues/260) excessive PNL checking after sort for spilling. 142 - Reworked checking `MAX_PAGENO` and DB upper-size geometry limit. 143 - [Fixed](https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/issues/265) build for some combinations of versions of MSVC and Windows SDK. 144 145 Minors: 146 147 - Added workaround for CLANG bug [D79919/PR42445](https://reviews.llvm.org/D79919). 148 - Fixed build test on Android (using `pthread_barrier_t` stub). 149 - Disabled C++20 concepts for CLANG < 14 on Android. 150 - Fixed minor `unused parameter` warning. 151 - Added CI for Android. 152 - Refine/cleanup internal logging. 153 - Refined line splitting inside hex/base58/base64 encoding to avoid `\n` at the end. 154 - Added workaround for modern libstdc++ with CLANG < 4.x 155 - Relaxed txn-check rules for auxiliary functions. 156 - Clarified a comments and descriptions, etc. 157 - Using the `-fno-semantic interposition` option to reduce the overhead to calling self own public functions. 158 159 160 ## v0.11.3 at 2021-12-31 161 162 Acknowledgements: 163 164 - [gcxfd <i@rmw.link>](https://github.com/gcxfd) for reporting, contributing and testing. 165 - [장세연 (Чан Се Ен)](https://github.com/sasgas) for reporting and testing. 166 - [Alex Sharov](https://github.com/AskAlexSharov) for reporting, testing and provide resources for remote debugging/investigation. 167 168 New features, extensions and improvements: 169 170 - [Added](https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/issues/236) `mdbx_cursor_get_batch()`. 171 - [Added](https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/issues/250) `MDBX_SET_UPPERBOUND`. 172 - C++ API is finalized now. 173 - The GC update stage has been [significantly speeded](https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/issues/254) when fixing huge Erigon's transactions (Ethereum ecosystem). 174 175 Fixes: 176 177 - Disabled C++20 concepts for stupid AppleClang 13.x 178 - Fixed internal collision of `MDBX_SHRINK_ALLOWED` with `MDBX_ACCEDE`. 179 180 Minors: 181 182 - Fixed returning `MDBX_RESULT_TRUE` (unexpected -1) from `mdbx_env_set_option()`. 183 - Added `mdbx_env_get_syncbytes()` and `mdbx_env_get_syncperiod()`. 184 - [Clarified](https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/pull/249) description of `MDBX_INTEGERKEY`. 185 - Reworked/simplified `mdbx_env_sync_internal()`. 186 - [Fixed](https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/issues/248) extra assertion inside `mdbx_cursor_put()` for `MDBX_DUPFIXED` cases. 187 - Avoiding extra looping inside `mdbx_env_info_ex()`. 188 - Explicitly enabled core dumps from stochastic tests scripts on Linux. 189 - [Fixed](https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/issues/253) `mdbx_override_meta()` to avoid false-positive assertions. 190 - For compatibility reverted returning `MDBX_ENODATA`for some cases. 191 192 193 ## v0.11.2 at 2021-12-02 194 195 Acknowledgements: 196 197 - [장세연 (Чан Се Ен)](https://github.com/sasgas) for contributing to C++ API. 198 - [Alain Picard](https://github.com/castortech) for [Java bindings](https://github.com/castortech/mdbxjni). 199 - [Alex Sharov](https://github.com/AskAlexSharov) for reporting and testing. 200 - [Kris Zyp](https://github.com/kriszyp) for reporting and testing. 201 - [Artem Vorotnikov](https://github.com/vorot93) for support [Rust wrapper](https://github.com/vorot93/libmdbx-rs). 202 203 Fixes: 204 205 - [Fixed compilation](https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/pull/239) with `devtoolset-9` on CentOS/RHEL 7. 206 - [Fixed unexpected `MDBX_PROBLEM` error](https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/issues/242) because of update an obsolete meta-page. 207 - [Fixed returning `MDBX_NOTFOUND` error](https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/issues/243) in case an inexact value found for `MDBX_GET_BOTH` operation. 208 - [Fixed compilation](https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/issues/245) without kernel/libc-devel headers. 209 210 Minors: 211 212 - Fixed `constexpr`-related macros for legacy compilers. 213 - Allowed to define 'CMAKE_CXX_STANDARD` using an environment variable. 214 - Simplified collection statistics of page operation . 215 - Added `MDBX_FORCE_BUILD_AS_MAIN_PROJECT` cmake option. 216 - Remove unneeded `#undef P_DIRTY`. 217 218 219 ## v0.11.1 at 2021-10-23 220 221 ### Backward compatibility break: 222 223 The database format signature has been changed to prevent 224 forward-interoperability with an previous releases, which may lead to a 225 [false positive diagnosis of database corruption](https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/issues/238) 226 due to flaws of an old library versions. 227 228 This change is mostly invisible: 229 230 - previously versions are unable to read/write a new DBs; 231 - but the new release is able to handle an old DBs and will silently upgrade ones. 232 233 Acknowledgements: 234 235 - [Alex Sharov](https://github.com/AskAlexSharov) for reporting and testing. 236 237 238 ------------------------------------------------------------------------------- 239 240 241 ## v0.10.5 at 2021-10-13 (obsolete, please use v0.11.1) 242 243 Unfortunately, the `v0.10.5` accidentally comes not full-compatible with previous releases: 244 245 - `v0.10.5` can read/processing DBs created by previous releases, i.e. the backward-compatibility is provided; 246 - however, previous releases may lead to false-corrupted state with DB that was touched by `v0.10.5`, i.e. the forward-compatibility is broken for `v0.10.4` and earlier. 247 248 This cannot be fixed, as it requires fixing past versions, which as a result we will just get a current version. 249 Therefore, it is recommended to use `v0.11.1` instead of `v0.10.5`. 250 251 Acknowledgements: 252 253 - [Noel Kuntze](https://github.com/Thermi) for immediately bug reporting. 254 255 Fixes: 256 257 - Fixed unaligned access regression after the `#pragma pack` fix for modern compilers. 258 - Added UBSAN-test to CI to avoid a regression(s) similar to lately fixed. 259 - Fixed possibility of meta-pages clashing after manually turn to a particular meta-page using `mdbx_chk` utility. 260 261 Minors: 262 263 - Refined handling of weak or invalid meta-pages while a DB opening. 264 - Refined providing information for the `@MAIN` and `@GC` sub-databases of a last committed modification transaction's ID. 265 266 267 ## v0.10.4 at 2021-10-10 268 269 Acknowledgements: 270 271 - [Artem Vorotnikov](https://github.com/vorot93) for support [Rust wrapper](https://github.com/vorot93/libmdbx-rs). 272 - [Andrew Ashikhmin](https://github.com/yperbasis) for contributing to C++ API. 273 274 Fixes: 275 276 - Fixed possibility of looping update GC during transaction commit (no public issue since the problem was discovered inside [Positive Technologies](https://www.ptsecurity.ru)). 277 - Fixed `#pragma pack` to avoid provoking some compilers to generate code with [unaligned access](https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/issues/235). 278 - Fixed `noexcept` for potentially throwing `txn::put()` of C++ API. 279 280 Minors: 281 282 - Added stochastic test script for checking small transactions cases. 283 - Removed extra transaction commit/restart inside test framework. 284 - In debugging builds fixed a too small (single page) by default DB shrink threshold. 285 286 287 ## v0.10.3 at 2021-08-27 288 289 Acknowledgements: 290 291 - [Francisco Vallarino](https://github.com/fjvallarino) for [Haskell bindings for libmdbx](https://hackage.haskell.org/package/libmdbx). 292 - [Alex Sharov](https://github.com/AskAlexSharov) for reporting and testing. 293 - [Andrea Lanfranchi](https://github.com/AndreaLanfranchi) for contributing. 294 295 Extensions and improvements: 296 297 - Added `cursor::erase()` overloads for `key` and for `key-value`. 298 - Resolve minor Coverity Scan issues (no fixes but some hint/comment were added). 299 - Resolve minor UndefinedBehaviorSanitizer issues (no fixes but some workaround were added). 300 301 Fixes: 302 303 - Always setup `madvise` while opening DB (fixes https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/issues/231). 304 - Fixed checking legacy `P_DIRTY` flag (`0x10`) for nested/sub-pages. 305 306 Minors: 307 308 - Fixed getting revision number from middle of history during amalgamation (GNU Makefile). 309 - Fixed search GCC tools for LTO (CMake scripts). 310 - Fixed/reorder dirs list for search CLANG tools for LTO (CMake scripts). 311 - Fixed/workarounds for CLANG < 9.x 312 - Fixed CMake warning about compatibility with 3.8.2 313 314 315 ## v0.10.2 at 2021-07-26 316 317 Acknowledgements: 318 319 - [Alex Sharov](https://github.com/AskAlexSharov) for reporting and testing. 320 - [Andrea Lanfranchi](https://github.com/AndreaLanfranchi) for reporting bugs. 321 - [Lionel Debroux](https://github.com/debrouxl) for fuzzing tests and reporting bugs. 322 - [Sergey Fedotov](https://github.com/SergeyFromHell/) for [`node-mdbx` NodeJS bindings](https://www.npmjs.com/package/node-mdbx). 323 - [Kris Zyp](https://github.com/kriszyp) for [`lmdbx-store` NodeJS bindings](https://github.com/kriszyp/lmdbx-store). 324 - [Noel Kuntze](https://github.com/Thermi) for [draft Python bindings](https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/commits/python-bindings). 325 326 New features, extensions and improvements: 327 328 - [Allow to predefine/override `MDBX_BUILD_TIMESTAMP` for builds reproducibility](https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/issues/201). 329 - Added options support for `long-stochastic` script. 330 - Avoided `MDBX_TXN_FULL` error for large transactions when possible. 331 - The `MDBX_READERS_LIMIT` increased to `32767`. 332 - Raise `MDBX_TOO_LARGE` under Valgrind/ASAN if being opened DB is 100 larger than RAM (to avoid hangs and OOM). 333 - Minimized the size of poisoned/unpoisoned regions to avoid Valgrind/ASAN stuck. 334 - Added more workarounds for QEMU for testing builds for 32-bit platforms, Alpha and Sparc architectures. 335 - `mdbx_chk` now skips iteration & checking of DB' records if corresponding page-tree is corrupted (to avoid `SIGSEGV`, ASAN failures, etc). 336 - Added more checks for [rare/fuzzing corruption cases](https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/issues/217). 337 338 Backward compatibility break: 339 340 - Use file `VERSION.txt` for version information instead of `VERSION` to avoid collision with `#include <version>`. 341 - Rename `slice::from/to_FOO_bytes()` to `slice::envisage_from/to_FOO_length()'. 342 - Rename `MDBX_TEST_EXTRA` make's variable to `MDBX_SMOKE_EXTRA`. 343 - Some details of the C++ API have been changed for subsequent freezing. 344 345 Fixes: 346 347 - Fixed excess meta-pages checks in case `mdbx_chk` is called to check the DB for a specific meta page and thus could prevent switching to the selected meta page, even if the check passed without errors. 348 - Fixed [recursive use of SRW-lock on Windows cause by `MDBX_NOTLS` option](https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/issues/203). 349 - Fixed [log a warning during a new DB creation](https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/issues/205). 350 - Fixed [false-negative `mdbx_cursor_eof()` result](https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/issues/207). 351 - Fixed [`make install` with non-GNU `install` utility (OSX, BSD)](https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/issues/208). 352 - Fixed [installation by `CMake` in special cases by complete use `GNUInstallDirs`'s variables](https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/issues/209). 353 - Fixed [C++ Buffer issue with `std::string` and alignment](https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/issues/191). 354 - Fixed `safe64_reset()` for platforms without atomic 64-bit compare-and-swap. 355 - Fixed hang/shutdown on big-endian platforms without `__cxa_thread_atexit()`. 356 - Fixed [using bad meta-pages if DB was partially/recoverable corrupted](https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/issues/217). 357 - Fixed extra `noexcept` for `buffer::&assign_reference()`. 358 - Fixed `bootid` generation on Windows for case of change system' time. 359 - Fixed [test framework keygen-related issue](https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/issues/127). 360 361 362 ## v0.10.1 at 2021-06-01 363 364 Acknowledgements: 365 366 - [Alexey Akhunov](https://github.com/AlexeyAkhunov) and [Alex Sharov](https://github.com/AskAlexSharov) for bug reporting and testing. 367 - [Andrea Lanfranchi](https://github.com/AndreaLanfranchi) for bug reporting and testing related to WSL2. 368 369 New features: 370 371 - Added `-p` option to `mdbx_stat` utility for printing page operations statistic. 372 - Added explicit checking for and warning about using unfit github's archives. 373 - Added fallback from [OFD locking](https://bit.ly/3yFRtYC) to legacy non-OFD POSIX file locks on an `EINVAL` error. 374 - Added [Plan 9](https://en.wikipedia.org/wiki/9P_(protocol)) network file system to the whitelist for an ability to open a DB in exclusive mode. 375 - Support for opening from WSL2 environment a DB hosted on Windows drive and mounted via [DrvFs](https://docs.microsoft.com/it-it/archive/blogs/wsl/wsl-file-system-support#drvfs) (i.e by Plan 9 noted above). 376 377 Fixes: 378 379 - Fixed minor "foo not used" warnings from modern C++ compilers when building the C++ part of the library. 380 - Fixed confusing/messy errors when build library from unfit github's archives (https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/issues/197). 381 - Fixed `#elsif` typo. 382 - Fixed rare unexpected `MDBX_PROBLEM` error during altering data in huge transactions due to wrong spilling/oust of dirty pages (https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/issues/195). 383 - Re-Fixed WSL1/WSL2 detection with distinguishing (https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/issues/97). 384 385 386 ## v0.10.0 at 2021-05-09 387 388 Acknowledgements: 389 390 - [Mahlon E. Smith](https://github.com/mahlonsmith) for [Ruby bindings](https://rubygems.org/gems/mdbx/). 391 - [Alex Sharov](https://github.com/AskAlexSharov) for [mdbx-go](https://github.com/torquem-ch/mdbx-go), bug reporting and testing. 392 - [Artem Vorotnikov](https://github.com/vorot93) for bug reporting and PR. 393 - [Paolo Rebuffo](https://www.linkedin.com/in/paolo-rebuffo-8255766/), [Alexey Akhunov](https://github.com/AlexeyAkhunov) and Mark Grosberg for donations. 394 - [Noel Kuntze](https://github.com/Thermi) for preliminary [Python bindings](https://github.com/Thermi/libmdbx/tree/python-bindings) 395 396 New features: 397 398 - Added `mdbx_env_set_option()` and `mdbx_env_get_option()` for controls 399 various runtime options for an environment (announce of this feature was missed in a previous news). 400 - Added `MDBX_DISABLE_PAGECHECKS` build option to disable some checks to reduce an overhead 401 and detection probability of database corruption to a values closer to the LMDB. 402 The `MDBX_DISABLE_PAGECHECKS=1` provides a performance boost of about 10% in CRUD scenarios, 403 and conjointly with the `MDBX_ENV_CHECKPID=0` and `MDBX_TXN_CHECKOWNER=0` options can yield 404 up to 30% more performance compared to LMDB. 405 - Using float point (exponential quantized) representation for internal 16-bit values 406 of grow step and shrink threshold when huge ones (https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/issues/166). 407 To minimize the impact on compatibility, only the odd values inside the upper half 408 of the range (i.e. 32769..65533) are used for the new representation. 409 - Added the `mdbx_drop` similar to LMDB command-line tool to purge or delete (sub)database(s). 410 - [Ruby bindings](https://rubygems.org/gems/mdbx/) is available now by [Mahlon E. Smith](https://github.com/mahlonsmith). 411 - Added `MDBX_ENABLE_MADVISE` build option which controls the use of POSIX `madvise()` hints and friends. 412 - The internal node sizes were refined, resulting in a reduction in large/overflow pages in some use cases 413 and a slight increase in limits for a keys size to ≈½ of page size. 414 - Added to `mdbx_chk` output number of keys/items on pages. 415 - Added explicit `install-strip` and `install-no-strip` targets to the `Makefile` (https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/pull/180). 416 - Major rework page splitting (af9b7b560505684249b76730997f9e00614b8113) for 417 - An "auto-appending" feature upon insertion for both ascending and 418 descending key sequences. As a result, the optimality of page filling 419 increases significantly (more densely, less slackness) while 420 inserting ordered sequences of keys, 421 - A "splitting at middle" to make page tree more balanced on average. 422 - Added `mdbx_get_sysraminfo()` to the API. 423 - Added guessing a reasonable maximum DB size for the default upper limit of geometry (https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/issues/183). 424 - Major rework internal labeling of a dirty pages (958fd5b9479f52f2124ab7e83c6b18b04b0e7dda) for 425 a "transparent spilling" feature with the gist to make a dirty pages 426 be ready to spilling (writing to a disk) without further altering ones. 427 Thus in the `MDBX_WRITEMAP` mode the OS kernel able to oust dirty pages 428 to DB file without further penalty during transaction commit. 429 As a result, page swapping and I/O could be significantly reduced during extra large transactions and/or lack of memory. 430 - Minimized reading leaf-pages during dropping subDB(s) and nested trees. 431 - Major rework a spilling of dirty pages to support [LRU](https://en.wikipedia.org/wiki/Cache_replacement_policies#Least_recently_used_(LRU)) 432 policy and prioritization for a large/overflow pages. 433 - Statistics of page operations (split, merge, copy, spill, etc) now available through `mdbx_env_info_ex()`. 434 - Auto-setup limit for length of dirty pages list (`MDBX_opt_txn_dp_limit` option). 435 - Support `make options` to list available build options. 436 - Support `make help` to list available make targets. 437 - Silently `make`'s build by default. 438 - Preliminary [Python bindings](https://github.com/Thermi/libmdbx/tree/python-bindings) is available now 439 by [Noel Kuntze](https://github.com/Thermi) (https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/issues/147). 440 441 Backward compatibility break: 442 443 - The `MDBX_AVOID_CRT` build option was renamed to `MDBX_WITHOUT_MSVC_CRT`. 444 This option is only relevant when building for Windows. 445 - The `mdbx_env_stat()` always, and `mdbx_env_stat_ex()` when called with the zeroed transaction parameter, 446 now internally start temporary read transaction and thus may returns `MDBX_BAD_RSLOT` error. 447 So, just never use deprecated `mdbx_env_stat()' and call `mdbx_env_stat_ex()` with transaction parameter. 448 - The build option `MDBX_CONFIG_MANUAL_TLS_CALLBACK` was removed and now just a non-zero value of 449 the `MDBX_MANUAL_MODULE_HANDLER` macro indicates the requirement to manually call `mdbx_module_handler()` 450 when loading libraries and applications uses statically linked libmdbx on an obsolete Windows versions. 451 452 Fixes: 453 454 - Fixed performance regression due non-optimal C11 atomics usage (https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/issues/160). 455 - Fixed "reincarnation" of subDB after it deletion (https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/issues/168). 456 - Fixed (disallowing) implicit subDB deletion via operations on `@MAIN`'s DBI-handle. 457 - Fixed a crash of `mdbx_env_info_ex()` in case of a call for a non-open environment (https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/issues/171). 458 - Fixed the selecting/adjustment values inside `mdbx_env_set_geometry()` for implicit out-of-range cases (https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/issues/170). 459 - Fixed `mdbx_env_set_option()` for set initial and limit size of dirty page list ((https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/issues/179). 460 - Fixed an unreasonably huge default upper limit for DB geometry (https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/issues/183). 461 - Fixed `constexpr` specifier for the `slice::invalid()`. 462 - Fixed (no)readahead auto-handling (https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/issues/164). 463 - Fixed non-alloy build for Windows. 464 - Switched to using Heap-functions instead of LocalAlloc/LocalFree on Windows. 465 - Fixed `mdbx_env_stat_ex()` to returning statistics of the whole environment instead of MainDB only (https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/issues/190). 466 - Fixed building by GCC 4.8.5 (added workaround for a preprocessor's bug). 467 - Fixed building C++ part for iOS <= 13.0 (unavailability of `std::filesystem::path`). 468 - Fixed building for Windows target versions prior to Windows Vista (`WIN32_WINNT < 0x0600`). 469 - Fixed building by MinGW for Windows (https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/issues/155). 470 471 472 ------------------------------------------------------------------------------- 473 474 475 ## v0.9.3 at 2021-02-02 476 477 Acknowledgements: 478 479 - [Mahlon E. Smith](http://www.martini.nu/) for [FreeBSD port of libmdbx](https://svnweb.freebsd.org/ports/head/databases/mdbx/). 480 - [장세연](http://www.castis.com) for bug fixing and PR. 481 - [Clément Renault](https://github.com/Kerollmops/heed) for [Heed](https://github.com/Kerollmops/heed) fully typed Rust wrapper. 482 - [Alex Sharov](https://github.com/AskAlexSharov) for bug reporting. 483 - [Noel Kuntze](https://github.com/Thermi) for bug reporting. 484 485 Removed options and features: 486 487 - Drop `MDBX_HUGE_TRANSACTIONS` build-option (now no longer required). 488 489 New features: 490 491 - Package for FreeBSD is available now by Mahlon E. Smith. 492 - New API functions to get/set various options (https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/issues/128): 493 - the maximum number of named databases for the environment; 494 - the maximum number of threads/reader slots; 495 - threshold (since the last unsteady commit) to force flush the data buffers to disk; 496 - relative period (since the last unsteady commit) to force flush the data buffers to disk; 497 - limit to grow a list of reclaimed/recycled page's numbers for finding a sequence of contiguous pages for large data items; 498 - limit to grow a cache of dirty pages for reuse in the current transaction; 499 - limit of a pre-allocated memory items for dirty pages; 500 - limit of dirty pages for a write transaction; 501 - initial allocation size for dirty pages list of a write transaction; 502 - maximal part of the dirty pages may be spilled when necessary; 503 - minimal part of the dirty pages should be spilled when necessary; 504 - how much of the parent transaction dirty pages will be spilled while start each child transaction; 505 - Unlimited/Dynamic size of retired and dirty page lists (https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/issues/123). 506 - Added `-p` option (purge subDB before loading) to `mdbx_load` tool. 507 - Reworked spilling of large transaction and committing of nested transactions: 508 - page spilling code reworked to avoid the flaws and bugs inherited from LMDB; 509 - limit for number of dirty pages now is controllable at runtime; 510 - a spilled pages, including overflow/large pages, now can be reused and refunded/compactified in nested transactions; 511 - more effective refunding/compactification especially for the loosed page cache. 512 - Added `MDBX_ENABLE_REFUND` and `MDBX_PNL_ASCENDING` internal/advanced build options. 513 - Added `mdbx_default_pagesize()` function. 514 - Better support architectures with a weak/relaxed memory consistency model (ARM, AARCH64, PPC, MIPS, RISC-V, etc) by means [C11 atomics](https://en.cppreference.com/w/c/atomic). 515 - Speed up page number lists and dirty page lists (https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/issues/132). 516 - Added `LIBMDBX_NO_EXPORTS_LEGACY_API` build option. 517 518 Fixes: 519 520 - Fixed missing cleanup (null assigned) in the C++ commit/abort (https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/pull/143). 521 - Fixed `mdbx_realloc()` for case of nullptr and `MDBX_WITHOUT_MSVC_CRT=ON` for Windows. 522 - Fixed the possibility to use invalid and renewed (closed & re-opened, dropped & re-created) DBI-handles (https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/issues/146). 523 - Fixed 4-byte aligned access to 64-bit integers, including access to the `bootid` meta-page's field (https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/issues/153). 524 - Fixed minor/potential memory leak during page flushing and unspilling. 525 - Fixed handling states of cursors's and subDBs's for nested transactions. 526 - Fixed page leak in extra rare case the list of retired pages changed during update GC on transaction commit. 527 - Fixed assertions to avoid false-positive UB detection by CLANG/LLVM (https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/issues/153). 528 - Fixed `MDBX_TXN_FULL` and regressive `MDBX_KEYEXIST` during large transaction commit with `MDBX_LIFORECLAIM` (https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/issues/123). 529 - Fixed auto-recovery (`weak->steady` with the same boot-id) when Database size at last weak checkpoint is large than at last steady checkpoint. 530 - Fixed operation on systems with unusual small/large page size, including PowerPC (https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/issues/157). 531 532 533 ## v0.9.2 at 2020-11-27 534 535 Acknowledgements: 536 537 - Jens Alfke (Mobile Architect at [Couchbase](https://www.couchbase.com/)) for [NimDBX](https://github.com/snej/nimdbx). 538 - Clément Renault (CTO at [MeiliSearch](https://www.meilisearch.com/)) for [mdbx-rs](https://github.com/Kerollmops/mdbx-rs). 539 - Alex Sharov (Go-Lang Teach Lead at [TurboGeth/Ethereum](https://ethereum.org/)) for an extreme test cases and bug reporting. 540 - George Hazan (CTO at [Miranda NG](https://www.miranda-ng.org/)) for bug reporting. 541 - [Positive Technologies](https://www.ptsecurity.com/) for funding and [The Standoff](https://standoff365.com/). 542 543 Added features: 544 545 - Provided package for [buildroot](https://buildroot.org/). 546 - Binding for Nim is [available](https://github.com/snej/nimdbx) now by Jens Alfke. 547 - Added `mdbx_env_delete()` for deletion an environment files in a proper and multiprocess-safe way. 548 - Added `mdbx_txn_commit_ex()` with collecting latency information. 549 - Fast completion pure nested transactions. 550 - Added `LIBMDBX_INLINE_API` macro and inline versions of some API functions. 551 - Added `mdbx_cursor_copy()` function. 552 - Extended tests for checking cursor tracking. 553 - Added `MDBX_SET_LOWERBOUND` operation for `mdbx_cursor_get()`. 554 555 Fixes: 556 557 - Fixed missing installation of `mdbx.h++`. 558 - Fixed use of obsolete `__noreturn`. 559 - Fixed use of `yield` instruction on ARM if unsupported. 560 - Added pthread workaround for buggy toolchain/cmake/buildroot. 561 - Fixed use of `pthread_yield()` for non-GLIBC. 562 - Fixed use of `RegGetValueA()` on Windows 2000/XP. 563 - Fixed use of `GetTickCount64()` on Windows 2000/XP. 564 - Fixed opening DB on a network shares (in the exclusive mode). 565 - Fixed copy&paste typos. 566 - Fixed minor false-positive GCC warning. 567 - Added workaround for broken `DEFINE_ENUM_FLAG_OPERATORS` from Windows SDK. 568 - Fixed cursor state after multimap/dupsort repeated deletes (https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/issues/121). 569 - Added `SIGPIPE` suppression for internal thread during `mdbx_env_copy()`. 570 - Fixed extra-rare `MDBX_KEY_EXIST` error during `mdbx_commit()` (https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/issues/131). 571 - Fixed spilled pages checking (https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/issues/126). 572 - Fixed `mdbx_load` for 'plain text' and without `-s name` cases (https://web.archive.org/web/20220414235959/https://github.com/erthink/libmdbx/issues/136). 573 - Fixed save/restore/commit of cursors for nested transactions. 574 - Fixed cursors state in rare/special cases (move next beyond end-of-data, after deletion and so on). 575 - Added workaround for MSVC 19.28 (Visual Studio 16.8) (but may still hang during compilation). 576 - Fixed paranoidal Clang C++ UB for bitwise operations with flags defined by enums. 577 - Fixed large pages checking (for compatibility and to avoid false-positive errors from `mdbx_chk`). 578 - Added workaround for Wine (https://github.com/miranda-ng/miranda-ng/issues/1209). 579 - Fixed `ERROR_NOT_SUPPORTED` while opening DB by UNC pathnames (https://github.com/miranda-ng/miranda-ng/issues/2627). 580 - Added handling `EXCEPTION_POSSIBLE_DEADLOCK` condition for Windows. 581 582 583 ## v0.9.1 2020-09-30 584 585 Added features: 586 587 - Preliminary C++ API with support for C++17 polymorphic allocators. 588 - [Online C++ API reference](https://libmdbx.website.yandexcloud.net/) by Doxygen. 589 - Quick reference for Insert/Update/Delete operations. 590 - Explicit `MDBX_SYNC_DURABLE` to sync modes for API clarity. 591 - Explicit `MDBX_ALLDUPS` and `MDBX_UPSERT` for API clarity. 592 - Support for read transactions preparation (`MDBX_TXN_RDONLY_PREPARE` flag). 593 - Support for cursor preparation/(pre)allocation and reusing (`mdbx_cursor_create()` and `mdbx_cursor_bind()` functions). 594 - Support for checking database using specified meta-page (see `mdbx_chk -h`). 595 - Support for turn to the specific meta-page after checking (see `mdbx_chk -h`). 596 - Support for explicit reader threads (de)registration. 597 - The `mdbx_txn_break()` function to explicitly mark a transaction as broken. 598 - Improved handling of corrupted databases by `mdbx_chk` utility and `mdbx_walk_tree()` function. 599 - Improved DB corruption detection by checking parent-page-txnid. 600 - Improved opening large DB (> 4Gb) from 32-bit code. 601 - Provided `pure-function` and `const-function` attributes to C API. 602 - Support for user-settable context for transactions & cursors. 603 - Revised API and documentation related to Handle-Slow-Readers callback feature. 604 605 Deprecated functions and flags: 606 607 - For clarity and API simplification the `MDBX_MAPASYNC` flag is deprecated. 608 Just use `MDBX_SAFE_NOSYNC` or `MDBX_UTTERLY_NOSYNC` instead of it. 609 - `MDBX_oom_func`, `mdbx_env_set_oomfunc()` and `mdbx_env_get_oomfunc()` 610 replaced with `MDBX_hsr_func`, `mdbx_env_get_hsr` and `mdbx_env_get_hsr()`. 611 612 Fixes: 613 614 - Fix `mdbx_strerror()` for `MDBX_BUSY` error (no error description is returned). 615 - Fix update internal meta-geo information in read-only mode (`EACCESS` or `EBADFD` error). 616 - Fix `mdbx_page_get()` null-defer when DB corrupted (crash by `SIGSEGV`). 617 - Fix `mdbx_env_open()` for re-opening after non-fatal errors (`mdbx_chk` unexpected failures). 618 - Workaround for MSVC 19.27 `static_assert()` bug. 619 - Doxygen descriptions and refinement. 620 - Update Valgrind's suppressions. 621 - Workaround to avoid infinite loop of 'nested' testcase on MIPS under QEMU. 622 - Fix a lot of typos & spelling (Thanks to Josh Soref for PR). 623 - Fix `getopt()` messages for Windows (Thanks to Andrey Sporaw for reporting). 624 - Fix MSVC compiler version requirements (Thanks to Andrey Sporaw for reporting). 625 - Workarounds for QEMU's bugs to run tests for cross-builded library under QEMU. 626 - Now C++ compiler optional for building by CMake. 627 628 629 ## v0.9.0 2020-07-31 (not a release, but API changes) 630 631 Added features: 632 633 - [Online C API reference](https://libmdbx.website.yandexcloud.net/) by Doxygen. 634 - Separated enums for environment, sub-databases, transactions, copying and data-update flags. 635 636 Deprecated functions and flags: 637 638 - Usage of custom comparators and the `mdbx_dbi_open_ex()` are deprecated, since such databases couldn't be checked by the `mdbx_chk` utility. 639 Please use the value-to-key functions to provide keys that are compatible with the built-in libmdbx comparators. 640 641 642 ------------------------------------------------------------------------------- 643 644 645 ## 2020-07-06 646 647 - Added support multi-opening the same DB in a process with SysV locking (BSD). 648 - Fixed warnings & minors for LCC compiler (E2K). 649 - Enabled to simultaneously open the same database from processes with and without the `MDBX_WRITEMAP` option. 650 - Added key-to-value, `mdbx_get_keycmp()` and `mdbx_get_datacmp()` functions (helpful to avoid using custom comparators). 651 - Added `ENABLE_UBSAN` CMake option to enabling the UndefinedBehaviorSanitizer from GCC/CLANG. 652 - Workaround for [CLANG bug](https://bugs.llvm.org/show_bug.cgi?id=43275). 653 - Returning `MDBX_CORRUPTED` in case all meta-pages are weak and no other error. 654 - Refined mode bits while auto-creating LCK-file. 655 - Avoids unnecessary database file re-mapping in case geometry changed by another process(es). 656 From the user's point of view, the `MDBX_UNABLE_EXTEND_MAPSIZE` error will now be returned less frequently and only when using the DB in the current process really requires it to be reopened. 657 - Remapping on-the-fly and of the database file was implemented. 658 Now remapping with a change of address is performed automatically if there are no dependent readers in the current process. 659 660 661 ## 2020-06-12 662 663 - Minor change versioning. The last number in the version now means the number of commits since last release/tag. 664 - Provide ChangeLog file. 665 - Fix for using libmdbx as a C-only sub-project with CMake. 666 - Fix `mdbx_env_set_geometry()` for case it is called from an opened environment outside of a write transaction. 667 - Add support for huge transactions and `MDBX_HUGE_TRANSACTIONS` build-option (default `OFF`). 668 - Refine LTO (link time optimization) for clang. 669 - Force enabling exceptions handling for MSVC (`/EHsc` option). 670 671 672 ## 2020-06-05 673 674 - Support for Android/Bionic. 675 - Support for iOS. 676 - Auto-handling `MDBX_NOSUBDIR` while opening for any existing database. 677 - Engage github-actions to make release-assets. 678 - Clarify API description. 679 - Extended keygen-cases in stochastic test. 680 - Fix fetching of first/lower key from LEAF2-page during page merge. 681 - Fix missing comma in array of error messages. 682 - Fix div-by-zero while copy-with-compaction for non-resizable environments. 683 - Fixes & enhancements for custom-comparators. 684 - Fix `MDBX_WITHOUT_MSVC_CRT` option and missing `ntdll.def`. 685 - Fix `mdbx_env_close()` to work correctly called concurrently from several threads. 686 - Fix null-deref in an ASAN-enabled builds while opening the environment with error and/or read-only. 687 - Fix AddressSanitizer errors after closing the environment. 688 - Fix/workaround to avoid GCC 10.x pedantic warnings. 689 - Fix using `ENODATA` for FreeBSD. 690 - Avoid invalidation of DBI-handle(s) when it just closes. 691 - Avoid using `pwritev()` for single-writes (up to 10% speedup for some kernels & scenarios). 692 - Avoiding `MDBX_UTTERLY_NOSYNC` as result of flags merge. 693 - Add `mdbx_dbi_dupsort_depthmask()` function. 694 - Add `MDBX_CP_FORCE_RESIZEABLE` option. 695 - Add deprecated `MDBX_MAP_RESIZED` for compatibility. 696 - Add `MDBX_BUILD_TOOLS` option (default `ON`). 697 - Refine `mdbx_dbi_open_ex()` to safe concurrently opening the same handle from different threads. 698 - Truncate clk-file during environment closing. So a zero-length lck-file indicates that the environment was closed properly. 699 - Refine `mdbx_update_gc()` for huge transactions with small sizes of database page. 700 - Extends dump/load to support all MDBX attributes. 701 - Avoid upsertion the same key-value data, fix related assertions. 702 - Rework min/max length checking for keys & values. 703 - Checking the order of keys on all pages during checking. 704 - Support `CFLAGS_EXTRA` make-option for convenience. 705 - Preserve the last txnid while copying with compactification. 706 - Auto-reset running transaction in mdbx_txn_renew(). 707 - Automatically abort errored transaction in mdbx_txn_commit(). 708 - Auto-choose page size for large databases. 709 - Rearrange source files, rework build, options-support by CMake. 710 - Crutch for WSL1 (Windows subsystem for Linux). 711 - Refine install/uninstall targets. 712 - Support for Valgrind 3.14 and later. 713 - Add check-analyzer check-ubsan check-asan check-leak targets to Makefile. 714 - Minor fix/workaround to avoid UBSAN traps for `memcpy(ptr, NULL, 0)`. 715 - Avoid some GCC-analyzer false-positive warnings. 716 717 718 ## 2020-03-18 719 720 - Workarounds for Wine (Windows compatibility layer for Linux). 721 - `MDBX_MAP_RESIZED` renamed to `MDBX_UNABLE_EXTEND_MAPSIZE`. 722 - Clarify API description, fix typos. 723 - Speedup runtime checks in debug/checked builds. 724 - Added checking for read/write transactions overlapping for the same thread, added `MDBX_TXN_OVERLAPPING` error and `MDBX_DBG_LEGACY_OVERLAP` option. 725 - Added `mdbx_key_from_jsonInteger()`, `mdbx_key_from_double()`, `mdbx_key_from_float()`, `mdbx_key_from_int64()` and `mdbx_key_from_int32()` functions. See `mdbx.h` for description. 726 - Fix compatibility (use zero for invalid DBI). 727 - Refine/clarify error messages. 728 - Avoids extra error messages "bad txn" from mdbx_chk when DB is corrupted. 729 730 731 ## 2020-01-21 732 733 - Fix `mdbx_load` utility for custom comparators. 734 - Fix checks related to `MDBX_APPEND` flag inside `mdbx_cursor_put()`. 735 - Refine/fix dbi_bind() internals. 736 - Refine/fix handling `STATUS_CONFLICTING_ADDRESSES`. 737 - Rework `MDBX_DBG_DUMP` option to avoid disk I/O performance degradation. 738 - Add built-in help to test tool. 739 - Fix `mdbx_env_set_geometry()` for large page size. 740 - Fix env_set_geometry() for large pagesize. 741 - Clarify API description & comments, fix typos. 742 743 744 ## 2019-12-31 745 746 - Fix returning MDBX_RESULT_TRUE from page_alloc(). 747 - Fix false-positive ASAN issue. 748 - Fix assertion for `MDBX_NOTLS` option. 749 - Rework `MADV_DONTNEED` threshold. 750 - Fix `mdbx_chk` utility for don't checking some numbers if walking on the B-tree was disabled. 751 - Use page's mp_txnid for basic integrity checking. 752 - Add `MDBX_FORCE_ASSERTIONS` built-time option. 753 - Rework `MDBX_DBG_DUMP` to avoid performance degradation. 754 - Rename `MDBX_NOSYNC` to `MDBX_SAFE_NOSYNC` for clarity. 755 - Interpret `ERROR_ACCESS_DENIED` from `OpenProcess()` as 'process exists'. 756 - Avoid using `FILE_FLAG_NO_BUFFERING` for compatibility with small database pages. 757 - Added install section for CMake. 758 759 760 ## 2019-12-02 761 762 - Support for Mac OSX, FreeBSD, NetBSD, OpenBSD, DragonFly BSD, OpenSolaris, OpenIndiana (AIX and HP-UX pending). 763 - Use bootid for decisions of rollback. 764 - Counting retired pages and extended transaction info. 765 - Add `MDBX_ACCEDE` flag for database opening. 766 - Using OFD-locks and tracking for in-process multi-opening. 767 - Hot backup into pipe. 768 - Support for cmake & amalgamated sources. 769 - Fastest internal sort implementation. 770 - New internal dirty-list implementation with lazy sorting. 771 - Support for lazy-sync-to-disk with polling. 772 - Extended key length. 773 - Last update transaction number for each sub-database. 774 - Automatic read ahead enabling/disabling. 775 - More auto-compactification. 776 - Using -fsanitize=undefined and -Wpedantic options. 777 - Rework page merging. 778 - Nested transactions. 779 - API description. 780 - Checking for non-local filesystems to avoid DB corruption. 781 782 ------------------------------------------------------------------------------- 783 784 For early changes see the git commit history.