2020-07-12 03:27:29 +08:00
ChangeLog
---------
2021-05-08 04:07:29 +08:00
## v0.10.1 (in development)
2020-09-22 05:41:05 +08:00
2020-12-03 14:36:45 +08:00
TODO:
2021-02-07 07:53:27 +08:00
2021-05-08 04:07:29 +08:00
- [Get rid of dirty-pages list in MDBX_WRITEMAP mode ](https://github.com/erthink/libmdbx/issues/193 ).
- [Large/Overflow pages accounting for dirty-room ](https://github.com/erthink/libmdbx/issues/192 ).
- [C++ Buffer issue ](https://github.com/erthink/libmdbx/issues/191 ).
2020-11-18 17:37:27 +08:00
- Finalize C++ API (few typos and trivia bugs are still likely for now).
2021-05-03 06:16:37 +08:00
- [Support for RAW devices ](https://github.com/erthink/libmdbx/issues/124 ).
2021-05-08 04:07:29 +08:00
- [Test framework issue ](https://github.com/erthink/libmdbx/issues/127 ).
2021-05-03 06:16:37 +08:00
- [Support MessagePack for Keys & Values ](https://github.com/erthink/libmdbx/issues/115 ).
- [Engage new terminology ](https://github.com/erthink/libmdbx/issues/137 ).
- Packages for [Astra Linux ](https://astralinux.ru/ ), [ALT Linux ](https://www.altlinux.org/ ), [ROSA Linux ](https://www.rosalinux.ru/ ), Fedora/RHEL, Debian/Ubuntu.
2021-05-09 04:10:52 +08:00
## v0.10.0 at 2021-05-09
2020-09-22 05:41:05 +08:00
2021-02-07 19:32:27 +08:00
Acknowledgements:
2021-03-15 08:36:51 +08:00
- [Mahlon E. Smith ](https://github.com/mahlonsmith ) for [Ruby bindings ](https://rubygems.org/gems/mdbx/ ).
2021-05-09 04:10:52 +08:00
- [Alex Sharov ](https://github.com/AskAlexSharov ) for [mdbx-go ](https://github.com/torquem-ch/mdbx-go ), bug reporting and testing.
2021-03-20 00:13:22 +08:00
- [Artem Vorotnikov ](https://github.com/vorot93 ) for bug reporting and PR.
2021-05-03 06:16:37 +08:00
- [Paolo Rebuffo ](https://www.linkedin.com/in/paolo-rebuffo-8255766/ ), [Alexey Akhunov ](https://github.com/AlexeyAkhunov ) and Mark Grosberg for donations.
- [Noel Kuntze ](https://github.com/Thermi ) for preliminary [Python bindings ](https://github.com/Thermi/libmdbx/tree/python-bindings )
2021-02-07 19:32:27 +08:00
2021-02-07 07:53:27 +08:00
New features:
2021-05-09 04:10:52 +08:00
- Added `mdbx_env_set_option()` and `mdbx_env_get_option()` for controls
various runtime options for an environment (announce of this feature was missed in a previous news).
2021-02-07 07:53:27 +08:00
- Added `MDBX_DISABLE_PAGECHECKS` build option to disable some checks to reduce an overhead
and detection probability of database corruption to a values closer to the LMDB.
The `MDBX_DISABLE_PAGECHECKS=1` provides a performance boost of about 10% in CRUD scenarios,
and conjointly with the `MDBX_ENV_CHECKPID=0` and `MDBX_TXN_CHECKOWNER=0` options can yield
up to 30% more performance compared to LMDB.
2021-03-09 16:54:20 +08:00
- Using float point (exponential quantized) representation for internal 16-bit values
of grow step and shrink threshold when huge ones (https://github.com/erthink/libmdbx/issues/166).
To minimize the impact on compatibility, only the odd values inside the upper half
of the range (i.e. 32769..65533) are used for the new representation.
2021-03-10 19:43:49 +08:00
- Added the `mdbx_drop` similar to LMDB command-line tool to purge or delete (sub)database(s).
2021-03-15 08:36:51 +08:00
- [Ruby bindings ](https://rubygems.org/gems/mdbx/ ) is available now by [Mahlon E. Smith ](https://github.com/mahlonsmith ).
2021-02-26 09:10:56 +08:00
- Added `MDBX_ENABLE_MADVISE` build option which controls the use of POSIX `madvise()` hints and friends.
2021-05-09 04:10:52 +08:00
- The internal node sizes were refined, resulting in a reduction in large/overflow pages in some use cases
and a slight increase in limits for a keys size to ≈½ of page size.
2021-05-03 06:16:37 +08:00
- Added to `mdbx_chk` output number of keys/items on pages.
- Added explicit `install-strip` and `install-no-strip` targets to the `Makefile` (https://github.com/erthink/libmdbx/pull/180).
- Major rework page splitting (af9b7b560505684249b76730997f9e00614b8113) for
- An "auto-appending" feature upon insertion for both ascending and
descending key sequences. As a result, the optimality of page filling
increases significantly (more densely, less slackness) while
inserting ordered sequences of keys,
- A "splitting at middle" to make page tree more balanced on average.
- Added `mdbx_get_sysraminfo()` to the API.
- Added guessing a reasonable maximum DB size for the default upper limit of geometry (https://github.com/erthink/libmdbx/issues/183).
- Major rework internal labeling of a dirty pages (958fd5b9479f52f2124ab7e83c6b18b04b0e7dda) for
a "transparent spilling" feature with the gist to make a dirty pages
be ready to spilling (writing to a disk) without further altering ones.
Thus in the `MDBX_WRITEMAP` mode the OS kernel able to oust dirty pages
to DB file without further penalty during transaction commit.
As a result, page swapping and I/O could be significantly reduced during extra large transactions and/or lack of memory.
- Minimized reading leaf-pages during dropping subDB(s) and nested trees.
2021-05-09 04:10:52 +08:00
- Major rework a spilling of dirty pages to support [LRU ](https://en.wikipedia.org/wiki/Cache_replacement_policies#Least_recently_used_(LRU ))
policy and prioritization for a large/overflow pages.
2021-05-03 06:16:37 +08:00
- Statistics of page operations (split, merge, copy, spill, etc) now available through `mdbx_env_info_ex()` .
- Auto-setup limit for length of dirty pages list (`MDBX_opt_txn_dp_limit` option).
2021-04-30 19:05:36 +08:00
- Support `make options` to list available build options.
2021-05-01 06:02:28 +08:00
- Support `make help` to list available make targets.
2021-05-03 06:16:37 +08:00
- Silently `make` 's build by default.
2021-05-09 04:10:52 +08:00
- Preliminary [Python bindings ](https://github.com/Thermi/libmdbx/tree/python-bindings ) is available now
by [Noel Kuntze ](https://github.com/Thermi ) (https://github.com/erthink/libmdbx/issues/147).
2021-02-07 07:53:27 +08:00
2021-04-30 01:09:16 +08:00
Backward compatibility break:
- The `MDBX_AVOID_CRT` build option was renamed to `MDBX_WITHOUT_MSVC_CRT` .
2021-05-03 06:16:37 +08:00
This option is only relevant when building for Windows.
2021-05-09 04:10:52 +08:00
- The `mdbx_env_stat()` always, and `mdbx_env_stat_ex()` when called with the zeroed transaction parameter,
now internally start temporary read transaction and thus may returns `MDBX_BAD_RSLOT` error.
2021-05-03 06:16:37 +08:00
So, just never use deprecated `mdbx_env_stat()' and call ` mdbx_env_stat_ex()` with transaction parameter.
2021-05-09 04:10:52 +08:00
- The build option `MDBX_CONFIG_MANUAL_TLS_CALLBACK` was removed and now just a non-zero value of
the `MDBX_MANUAL_MODULE_HANDLER` macro indicates the requirement to manually call `mdbx_module_handler()`
when loading libraries and applications uses statically linked libmdbx on an obsolete Windows versions.
2021-04-30 01:09:16 +08:00
2021-02-07 07:53:27 +08:00
Fixes:
- Fixed performance regression due non-optimal C11 atomics usage (https://github.com/erthink/libmdbx/issues/160).
2021-03-08 00:46:56 +08:00
- Fixed "reincarnation" of subDB after it deletion (https://github.com/erthink/libmdbx/issues/168).
2021-03-13 21:44:39 +08:00
- Fixed (disallowing) implicit subDB deletion via operations on `@MAIN` 's DBI-handle.
2021-03-13 22:05:43 +08:00
- Fixed a crash of `mdbx_env_info_ex()` in case of a call for a non-open environment (https://github.com/erthink/libmdbx/issues/171).
2021-03-14 00:55:19 +08:00
- Fixed the selecting/adjustment values inside `mdbx_env_set_geometry()` for implicit out-of-range cases (https://github.com/erthink/libmdbx/issues/170).
2021-05-03 06:16:37 +08:00
- Fixed `mdbx_env_set_option()` for set initial and limit size of dirty page list ((https://github.com/erthink/libmdbx/issues/179).
- Fixed an unreasonably huge default upper limit for DB geometry (https://github.com/erthink/libmdbx/issues/183).
- Fixed `constexpr` specifier for the `slice::invalid()` .
- Fixed (no)readahead auto-handling (https://github.com/erthink/libmdbx/issues/164).
- Fixed non-alloy build for Windows.
- Switched to using Heap-functions instead of LocalAlloc/LocalFree on Windows.
- Fixed `mdbx_env_stat_ex()` to returning statistics of the whole environment instead of MainDB only (https://github.com/erthink/libmdbx/issues/190).
2021-05-05 04:22:20 +08:00
- Fixed building by GCC 4.8.5 (added workaround for a preprocessor's bug).
2021-05-09 04:10:52 +08:00
- Fixed building C++ part for iOS < = 13.0 (unavailability of `std::filesystem::path` ).
- Fixed building for Windows target versions prior to Windows Vista (`WIN32_WINNT < 0x0600 `).
- Fixed building by MinGW for Windows (https://github.com/erthink/libmdbx/issues/155).
2021-02-07 07:53:27 +08:00
mdbx: release v0.9.3
Acknowledgements:
-----------------
- [Mahlon E. Smith](http://www.martini.nu/) for [FreeBSD port of libmdbx](https://svnweb.freebsd.org/ports/head/databases/mdbx/).
- [장세연](http://www.castis.com) for bug fixing and PR.
- [Clément Renault](https://github.com/Kerollmops/heed) for [Heed](https://github.com/Kerollmops/heed) fully typed Rust wrapper.
- [Alex Sharov](https://github.com/AskAlexSharov) for bug reporting.
- [Noel Kuntze](https://github.com/Thermi) for bug reporting.
Removed options and features:
-----------------------------
- Drop `MDBX_HUGE_TRANSACTIONS` build-option (now no longer required).
New features:
-------------
- Package for FreeBSD is available now by Mahlon E. Smith.
- New API functions to get/set various options (https://github.com/erthink/libmdbx/issues/128):
- the maximum number of named databases for the environment;
- the maximum number of threads/reader slots;
- threshold (since the last unsteady commit) to force flush the data buffers to disk;
- relative period (since the last unsteady commit) to force flush the data buffers to disk;
- limit to grow a list of reclaimed/recycled page's numbers for finding a sequence of contiguous pages for large data items;
- limit to grow a cache of dirty pages for reuse in the current transaction;
- limit of a pre-allocated memory items for dirty pages;
- limit of dirty pages for a write transaction;
- initial allocation size for dirty pages list of a write transaction;
- maximal part of the dirty pages may be spilled when necessary;
- minimal part of the dirty pages should be spilled when necessary;
- how much of the parent transaction dirty pages will be spilled while start each child transaction;
- Unlimited/Dynamic size of retired and dirty page lists (https://github.com/erthink/libmdbx/issues/123).
- Added `-p` option (purge subDB before loading) to `mdbx_load` tool.
- Reworked spilling of large transaction and committing of nested transactions:
- page spilling code reworked to avoid the flaws and bugs inherited from LMDB;
- limit for number of dirty pages now is controllable at runtime;
- a spilled pages, including overflow/large pages, now can be reused and refunded/compactified in nested transactions;
- more effective refunding/compactification especially for the loosed page cache.
- Added `MDBX_ENABLE_REFUND` and `MDBX_PNL_ASCENDING` internal/advanced build options.
- Added `mdbx_default_pagesize()` function.
- 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).
- Speed up page number lists and dirty page lists (https://github.com/erthink/libmdbx/issues/132).
- Added `LIBMDBX_NO_EXPORTS_LEGACY_API` build option.
Fixes:
------
- Fixed missing cleanup (null assigned) in the C++ commit/abort (https://github.com/erthink/libmdbx/pull/143).
- Fixed `mdbx_realloc()` for case of nullptr and `MDBX_AVOID_CRT=ON` for Windows.
- Fixed the possibility to use invalid and renewed (closed & re-opened, dropped & re-created) DBI-handles (https://github.com/erthink/libmdbx/issues/146).
- Fixed 4-byte aligned access to 64-bit integers, including access to the `bootid` meta-page's field (https://github.com/erthink/libmdbx/issues/153).
- Fixed minor/potential memory leak during page flushing and unspilling.
- Fixed handling states of cursors's and subDBs's for nested transactions.
- Fixed page leak in extra rare case the list of retired pages changed during update GC on transaction commit.
- Fixed assertions to avoid false-positive UB detection by CLANG/LLVM (https://github.com/erthink/libmdbx/issues/153).
- Fixed `MDBX_TXN_FULL` and regressive `MDBX_KEYEXIST` during large transaction commit with `MDBX_LIFORECLAIM` (https://github.com/erthink/libmdbx/issues/123).
- Fixed auto-recovery (`weak->steady` with the same boot-id) when Database size at last weak checkpoint is large than at last steady checkpoint.
- Fixed operation on systems with unusual small/large page size, including PowerPC (https://github.com/erthink/libmdbx/issues/157).
TODO:
-----
- Engage new terminology (https://github.com/erthink/libmdbx/issues/137).
- Resolve few TODOs (https://github.com/erthink/libmdbx/issues/124, https://github.com/erthink/libmdbx/issues/127, https://github.com/erthink/libmdbx/issues/115).
- Finalize C++ API.
- Packages for [ROSA Linux](https://www.rosalinux.ru/), [ALT Linux](https://www.altlinux.org/), Fedora/RHEL, Debian/Ubuntu.
Change-Id: I414b8ef2e4b90e04fb344779c0e3f1b4bd1c06be
2021-02-03 03:18:21 +08:00
## v0.9.3 at 2021-02-02
2020-12-03 14:36:45 +08:00
Acknowledgements:
2020-12-03 23:42:10 +08:00
2021-01-27 02:01:07 +08:00
- [Mahlon E. Smith ](http://www.martini.nu/ ) for [FreeBSD port of libmdbx ](https://svnweb.freebsd.org/ports/head/databases/mdbx/ ).
- [장세연 ](http://www.castis.com ) for bug fixing and PR.
- [Clément Renault ](https://github.com/Kerollmops/heed ) for [Heed ](https://github.com/Kerollmops/heed ) fully typed Rust wrapper.
- [Alex Sharov ](https://github.com/AskAlexSharov ) for bug reporting.
2021-01-30 02:54:24 +08:00
- [Noel Kuntze ](https://github.com/Thermi ) for bug reporting.
2020-12-02 22:45:35 +08:00
Removed options and features:
2020-12-03 23:42:10 +08:00
- Drop `MDBX_HUGE_TRANSACTIONS` build-option (now no longer required).
2020-12-04 02:52:22 +08:00
New features:
2020-12-03 23:42:10 +08:00
2020-12-03 14:36:45 +08:00
- Package for FreeBSD is available now by Mahlon E. Smith.
2021-01-26 06:37:32 +08:00
- New API functions to get/set various options (https://github.com/erthink/libmdbx/issues/128):
2021-01-23 06:13:20 +08:00
- the maximum number of named databases for the environment;
- the maximum number of threads/reader slots;
- threshold (since the last unsteady commit) to force flush the data buffers to disk;
- relative period (since the last unsteady commit) to force flush the data buffers to disk;
- limit to grow a list of reclaimed/recycled page's numbers for finding a sequence of contiguous pages for large data items;
- limit to grow a cache of dirty pages for reuse in the current transaction;
- limit of a pre-allocated memory items for dirty pages;
- limit of dirty pages for a write transaction;
- initial allocation size for dirty pages list of a write transaction;
- maximal part of the dirty pages may be spilled when necessary;
- minimal part of the dirty pages should be spilled when necessary;
- how much of the parent transaction dirty pages will be spilled while start each child transaction;
2020-12-03 23:42:10 +08:00
- Unlimited/Dynamic size of retired and dirty page lists (https://github.com/erthink/libmdbx/issues/123).
2020-12-04 02:52:22 +08:00
- Added `-p` option (purge subDB before loading) to `mdbx_load` tool.
2021-01-26 06:37:32 +08:00
- Reworked spilling of large transaction and committing of nested transactions:
- page spilling code reworked to avoid the flaws and bugs inherited from LMDB;
- limit for number of dirty pages now is controllable at runtime;
- a spilled pages, including overflow/large pages, now can be reused and refunded/compactified in nested transactions;
- more effective refunding/compactification especially for the loosed page cache.
2021-01-22 03:09:52 +08:00
- Added `MDBX_ENABLE_REFUND` and `MDBX_PNL_ASCENDING` internal/advanced build options.
2021-01-30 02:19:58 +08:00
- Added `mdbx_default_pagesize()` function.
2021-01-30 07:28:12 +08:00
- 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 ).
2021-02-01 07:11:25 +08:00
- Speed up page number lists and dirty page lists (https://github.com/erthink/libmdbx/issues/132).
2021-02-02 05:25:48 +08:00
- Added `LIBMDBX_NO_EXPORTS_LEGACY_API` build option.
2020-12-03 14:36:45 +08:00
Fixes:
2020-12-03 23:42:10 +08:00
2020-12-03 14:36:45 +08:00
- Fixed missing cleanup (null assigned) in the C++ commit/abort (https://github.com/erthink/libmdbx/pull/143).
2021-04-30 01:09:16 +08:00
- Fixed `mdbx_realloc()` for case of nullptr and `MDBX_WITHOUT_MSVC_CRT=ON` for Windows.
2020-12-17 22:42:35 +08:00
- Fixed the possibility to use invalid and renewed (closed & re-opened, dropped & re-created) DBI-handles (https://github.com/erthink/libmdbx/issues/146).
2021-01-18 19:27:58 +08:00
- Fixed 4-byte aligned access to 64-bit integers, including access to the `bootid` meta-page's field (https://github.com/erthink/libmdbx/issues/153).
2021-01-22 03:09:52 +08:00
- Fixed minor/potential memory leak during page flushing and unspilling.
- Fixed handling states of cursors's and subDBs's for nested transactions.
- Fixed page leak in extra rare case the list of retired pages changed during update GC on transaction commit.
- Fixed assertions to avoid false-positive UB detection by CLANG/LLVM (https://github.com/erthink/libmdbx/issues/153).
2021-01-26 06:37:32 +08:00
- Fixed `MDBX_TXN_FULL` and regressive `MDBX_KEYEXIST` during large transaction commit with `MDBX_LIFORECLAIM` (https://github.com/erthink/libmdbx/issues/123).
2021-01-30 02:54:24 +08:00
- Fixed auto-recovery (`weak->steady` with the same boot-id) when Database size at last weak checkpoint is large than at last steady checkpoint.
2021-01-30 02:19:58 +08:00
- Fixed operation on systems with unusual small/large page size, including PowerPC (https://github.com/erthink/libmdbx/issues/157).
2020-12-02 22:45:35 +08:00
2021-01-22 03:09:52 +08:00
## v0.9.2 at 2020-11-27
2020-11-18 17:37:27 +08:00
Acknowledgements:
- Jens Alfke (Mobile Architect at [Couchbase ](https://www.couchbase.com/ )) for [NimDBX ](https://github.com/snej/nimdbx ).
- Clément Renault (CTO at [MeiliSearch ](https://www.meilisearch.com/ )) for [mdbx-rs ](https://github.com/Kerollmops/mdbx-rs ).
- Alex Sharov (Go-Lang Teach Lead at [TurboGeth/Ethereum ](https://ethereum.org/ )) for an extreme test cases and bug reporting.
- George Hazan (CTO at [Miranda NG ](https://www.miranda-ng.org/ )) for bug reporting.
- [Positive Technologies ](https://www.ptsecurity.com/ ) for funding and [The Standoff ](https://standoff365.com/ ).
2020-10-31 04:43:07 +08:00
2020-10-08 17:41:56 +08:00
Added features:
2020-11-15 13:02:25 +08:00
2020-10-08 17:41:56 +08:00
- Provided package for [buildroot ](https://buildroot.org/ ).
2020-11-18 17:37:27 +08:00
- Binding for Nim is [available ](https://github.com/snej/nimdbx ) now by Jens Alfke.
2020-10-10 03:43:14 +08:00
- Added `mdbx_env_delete()` for deletion an environment files in a proper and multiprocess-safe way.
2020-10-16 00:23:14 +08:00
- Added `mdbx_txn_commit_ex()` with collecting latency information.
2020-10-31 04:43:07 +08:00
- Fast completion pure nested transactions.
- Added `LIBMDBX_INLINE_API` macro and inline versions of some API functions.
2020-11-18 17:37:27 +08:00
- Added `mdbx_cursor_copy()` function.
- Extended tests for checking cursor tracking.
- Added `MDBX_SET_LOWERBOUND` operation for `mdbx_cursor_get()` .
2020-10-08 17:41:56 +08:00
2020-10-08 06:38:34 +08:00
Fixes:
- Fixed missing installation of `mdbx.h++` .
- Fixed use of obsolete `__noreturn` .
- Fixed use of `yield` instruction on ARM if unsupported.
- Added pthread workaround for buggy toolchain/cmake/buildroot.
- Fixed use of `pthread_yield()` for non-GLIBC.
- Fixed use of `RegGetValueA()` on Windows 2000/XP.
- Fixed use of `GetTickCount64()` on Windows 2000/XP.
- Fixed opening DB on a network shares (in the exclusive mode).
- Fixed copy& paste typos.
- Fixed minor false-positive GCC warning.
2020-10-11 01:07:00 +08:00
- Added workaround for broken `DEFINE_ENUM_FLAG_OPERATORS` from Windows SDK.
2020-10-23 08:33:08 +08:00
- Fixed cursor state after multimap/dupsort repeated deletes (https://github.com/erthink/libmdbx/issues/121).
- Added `SIGPIPE` suppression for internal thread during `mdbx_env_copy()` .
2020-11-18 17:37:27 +08:00
- Fixed extra-rare `MDBX_KEY_EXIST` error during `mdbx_commit()` (https://github.com/erthink/libmdbx/issues/131).
2020-10-31 04:43:07 +08:00
- Fixed spilled pages checking (https://github.com/erthink/libmdbx/issues/126).
2020-11-15 13:02:25 +08:00
- Fixed `mdbx_load` for 'plain text' and without `-s name` cases (https://github.com/erthink/libmdbx/issues/136).
2020-11-18 17:37:27 +08:00
- Fixed save/restore/commit of cursors for nested transactions.
- Fixed cursors state in rare/special cases (move next beyond end-of-data, after deletion and so on).
- Added workaround for MSVC 19.28 (Visual Studio 16.8) (but may still hang during compilation).
- Fixed paranoidal Clang C++ UB for bitwise operations with flags defined by enums.
- Fixed large pages checking (for compatibility and to avoid false-positive errors from `mdbx_chk` ).
2020-11-24 20:49:43 +08:00
- Added workaround for Wine (https://github.com/miranda-ng/miranda-ng/issues/1209).
- Fixed `ERROR_NOT_SUPPORTED` while opening DB by UNC pathnames (https://github.com/miranda-ng/miranda-ng/issues/2627).
2020-11-25 15:49:39 +08:00
- Added handling `EXCEPTION_POSSIBLE_DEADLOCK` condition for Windows.
2020-11-18 17:37:27 +08:00
2020-09-22 05:41:05 +08:00
2020-09-30 18:28:01 +08:00
## v0.9.1 2020-09-30
2020-08-07 17:34:05 +08:00
Added features:
2020-09-22 05:41:05 +08:00
- Preliminary C++ API with support for C++17 polymorphic allocators.
- [Online C++ API reference ](https://erthink.github.io/libmdbx/ ) by Doxygen.
- Quick reference for Insert/Update/Delete operations.
- Explicit `MDBX_SYNC_DURABLE` to sync modes for API clarity.
- Explicit `MDBX_ALLDUPS` and `MDBX_UPSERT` for API clarity.
2020-08-07 17:34:05 +08:00
- Support for read transactions preparation (`MDBX_TXN_RDONLY_PREPARE` flag).
2020-09-26 23:28:09 +08:00
- Support for cursor preparation/(pre)allocation and reusing (`mdbx_cursor_create()` and `mdbx_cursor_bind()` functions).
2020-09-22 05:41:05 +08:00
- Support for checking database using specified meta-page (see `mdbx_chk -h` ).
2020-09-25 07:17:57 +08:00
- Support for turn to the specific meta-page after checking (see `mdbx_chk -h` ).
2020-09-22 05:41:05 +08:00
- Support for explicit reader threads (de)registration.
- The `mdbx_txn_break()` function to explicitly mark a transaction as broken.
- Improved handling of corrupted databases by `mdbx_chk` utility and `mdbx_walk_tree()` function.
- Improved DB corruption detection by checking parent-page-txnid.
- Improved opening large DB (> 4Gb) from 32-bit code.
- Provided `pure-function` and `const-function` attributes to C API.
2020-09-30 01:58:09 +08:00
- Support for user-settable context for transactions & cursors.
2020-09-30 00:24:57 +08:00
- Revised API and documentation related to Handle-Slow-Readers callback feature.
2020-08-07 17:34:05 +08:00
2020-09-22 05:41:05 +08:00
Deprecated functions and flags:
2020-08-07 17:34:05 +08:00
2020-09-22 05:41:05 +08:00
- For clarity and API simplification the `MDBX_MAPASYNC` flag is deprecated.
Just use `MDBX_SAFE_NOSYNC` or `MDBX_UTTERLY_NOSYNC` instead of it.
2020-09-30 00:24:57 +08:00
- `MDBX_oom_func` , `mdbx_env_set_oomfunc()` and `mdbx_env_get_oomfunc()`
replaced with `MDBX_hsr_func` , `mdbx_env_get_hsr` and `mdbx_env_get_hsr()` .
2020-09-22 05:41:05 +08:00
Fixes:
- Fix `mdbx_strerror()` for `MDBX_BUSY` error (no error description is returned).
2020-09-26 23:28:09 +08:00
- Fix update internal meta-geo information in read-only mode (`EACCESS` or `EBADFD` error).
2020-09-22 05:41:05 +08:00
- Fix `mdbx_page_get()` null-defer when DB corrupted (crash by `SIGSEGV` ).
- Fix `mdbx_env_open()` for re-opening after non-fatal errors (`mdbx_chk` unexpected failures).
- Workaround for MSVC 19.27 `static_assert()` bug.
- Doxygen descriptions and refinement.
- Update Valgrind's suppressions.
- Workaround to avoid infinite loop of 'nested' testcase on MIPS under QEMU.
2020-09-25 07:17:57 +08:00
- Fix a lot of typos & spelling (Thanks to Josh Soref for PR).
- Fix `getopt()` messages for Windows (Thanks to Andrey Sporaw for reporting).
- Fix MSVC compiler version requirements (Thanks to Andrey Sporaw for reporting).
2020-09-22 05:41:05 +08:00
- Workarounds for QEMU's bugs to run tests for cross-builded library under QEMU.
2020-09-28 21:49:57 +08:00
- Now C++ compiler optional for building by CMake.
2020-09-22 05:41:05 +08:00
## v0.9.0 2020-07-31 (not a release, but API changes)
Added features:
- [Online C API reference ](https://erthink.github.io/libmdbx/ ) by Doxygen.
- Separated enums for environment, sub-databases, transactions, copying and data-update flags.
2020-08-07 17:34:05 +08:00
Deprecated functions and flags:
2020-09-22 05:41:05 +08:00
- Usage of custom comparators and the `mdbx_dbi_open_ex()` are deprecated, since such databases couldn't be checked by the `mdbx_chk` utility.
Please use the value-to-key functions to provide keys that are compatible with the built-in libmdbx comparators.
2020-08-07 17:34:05 +08:00
2020-07-05 06:42:01 +08:00
2020-08-23 01:19:46 +08:00
## v0.8.2 2020-07-06
2020-07-07 05:38:27 +08:00
- Added support multi-opening the same DB in a process with SysV locking (BSD).
- Fixed warnings & minors for LCC compiler (E2K).
- Enabled to simultaneously open the same database from processes with and without the `MDBX_WRITEMAP` option.
- Added key-to-value, `mdbx_get_keycmp()` and `mdbx_get_datacmp()` functions (helpful to avoid using custom comparators).
- Added `ENABLE_UBSAN` CMake option to enabling the UndefinedBehaviorSanitizer from GCC/CLANG.
- Workaround for [CLANG bug ](https://bugs.llvm.org/show_bug.cgi?id=43275 ).
- Returning `MDBX_CORRUPTED` in case all meta-pages are weak and no other error.
- Refined mode bits while auto-creating LCK-file.
- Avoids unnecessary database file re-mapping in case geometry changed by another process(es).
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.
- Remapping on-the-fly and of the database file was implemented.
Now remapping with a change of address is performed automatically if there are no dependent readers in the current process.
2020-06-13 08:07:15 +08:00
2020-08-07 17:34:05 +08:00
2020-08-23 01:19:46 +08:00
## v0.8.1 2020-06-12
2020-07-07 05:38:27 +08:00
- Minor change versioning. The last number in the version now means the number of commits since last release/tag.
- Provide ChangeLog file.
- Fix for using libmdbx as a C-only sub-project with CMake.
- Fix `mdbx_env_set_geometry()` for case it is called from an opened environment outside of a write transaction.
- Add support for huge transactions and `MDBX_HUGE_TRANSACTIONS` build-option (default `OFF` ).
- Refine LTO (link time optimization) for clang.
- Force enabling exceptions handling for MSVC (`/EHsc` option).
2020-06-13 08:07:15 +08:00
2020-08-07 17:34:05 +08:00
2020-08-23 01:19:46 +08:00
## v0.8.0 2020-06-05
2020-07-07 05:38:27 +08:00
- Support for Android/Bionic.
- Support for iOS.
- Auto-handling `MDBX_NOSUBDIR` while opening for any existing database.
- Engage github-actions to make release-assets.
- Clarify API description.
- Extended keygen-cases in stochastic test.
- Fix fetching of first/lower key from LEAF2-page during page merge.
- Fix missing comma in array of error messages.
- Fix div-by-zero while copy-with-compaction for non-resizable environments.
- Fixes & enhancements for custom-comparators.
2021-04-30 01:09:16 +08:00
- Fix `MDBX_WITHOUT_MSVC_CRT` option and missing `ntdll.def` .
2020-07-07 05:38:27 +08:00
- Fix `mdbx_env_close()` to work correctly called concurrently from several threads.
- Fix null-deref in an ASAN-enabled builds while opening the environment with error and/or read-only.
- Fix AddressSanitizer errors after closing the environment.
- Fix/workaround to avoid GCC 10.x pedantic warnings.
- Fix using `ENODATA` for FreeBSD.
- Avoid invalidation of DBI-handle(s) when it just closes.
- Avoid using `pwritev()` for single-writes (up to 10% speedup for some kernels & scenarios).
- Avoiding `MDBX_UTTERLY_NOSYNC` as result of flags merge.
- Add `mdbx_dbi_dupsort_depthmask()` function.
- Add `MDBX_CP_FORCE_RESIZEABLE` option.
- Add deprecated `MDBX_MAP_RESIZED` for compatibility.
- Add `MDBX_BUILD_TOOLS` option (default `ON` ).
- Refine `mdbx_dbi_open_ex()` to safe concurrently opening the same handle from different threads.
- Truncate clk-file during environment closing. So a zero-length lck-file indicates that the environment was closed properly.
- Refine `mdbx_update_gc()` for huge transactions with small sizes of database page.
- Extends dump/load to support all MDBX attributes.
- Avoid upsertion the same key-value data, fix related assertions.
- Rework min/max length checking for keys & values.
- Checking the order of keys on all pages during checking.
- Support `CFLAGS_EXTRA` make-option for convenience.
- Preserve the last txnid while copying with compactification.
- Auto-reset running transaction in mdbx_txn_renew().
- Automatically abort errored transaction in mdbx_txn_commit().
- Auto-choose page size for large databases.
- Rearrange source files, rework build, options-support by CMake.
- Crutch for WSL1 (Windows subsystem for Linux).
- Refine install/uninstall targets.
- Support for Valgrind 3.14 and later.
- Add check-analyzer check-ubsan check-asan check-leak targets to Makefile.
- Minor fix/workaround to avoid UBSAN traps for `memcpy(ptr, NULL, 0)` .
- Avoid some GCC-analyzer false-positive warnings.
2020-06-13 08:07:15 +08:00
2020-08-07 17:34:05 +08:00
2020-08-23 01:19:46 +08:00
## v0.7.0 2020-03-18
2020-07-07 05:38:27 +08:00
- Workarounds for Wine (Windows compatibility layer for Linux).
- `MDBX_MAP_RESIZED` renamed to `MDBX_UNABLE_EXTEND_MAPSIZE` .
- Clarify API description, fix typos.
- Speedup runtime checks in debug/checked builds.
- Added checking for read/write transactions overlapping for the same thread, added `MDBX_TXN_OVERLAPPING` error and `MDBX_DBG_LEGACY_OVERLAP` option.
- 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.
- Fix compatibility (use zero for invalid DBI).
- Refine/clarify error messages.
- Avoids extra error messages "bad txn" from mdbx_chk when DB is corrupted.
2020-06-13 08:07:15 +08:00
2020-08-07 17:34:05 +08:00
2020-08-23 01:19:46 +08:00
## v0.6.0 2020-01-21
2020-07-07 05:38:27 +08:00
- Fix `mdbx_load` utility for custom comparators.
- Fix checks related to `MDBX_APPEND` flag inside `mdbx_cursor_put()` .
- Refine/fix dbi_bind() internals.
- Refine/fix handling `STATUS_CONFLICTING_ADDRESSES` .
- Rework `MDBX_DBG_DUMP` option to avoid disk I/O performance degradation.
- Add built-in help to test tool.
- Fix `mdbx_env_set_geometry()` for large page size.
- Fix env_set_geometry() for large pagesize.
- Clarify API description & comments, fix typos.
2020-06-13 08:07:15 +08:00
2020-08-07 17:34:05 +08:00
2020-08-23 01:19:46 +08:00
## v0.5.0 2019-12-31
2020-07-07 05:38:27 +08:00
- Fix returning MDBX_RESULT_TRUE from page_alloc().
- Fix false-positive ASAN issue.
- Fix assertion for `MDBX_NOTLS` option.
- Rework `MADV_DONTNEED` threshold.
- Fix `mdbx_chk` utility for don't checking some numbers if walking on the B-tree was disabled.
- Use page's mp_txnid for basic integrity checking.
- Add `MDBX_FORCE_ASSERTIONS` built-time option.
- Rework `MDBX_DBG_DUMP` to avoid performance degradation.
- Rename `MDBX_NOSYNC` to `MDBX_SAFE_NOSYNC` for clarity.
- Interpret `ERROR_ACCESS_DENIED` from `OpenProcess()` as 'process exists'.
- Avoid using `FILE_FLAG_NO_BUFFERING` for compatibility with small database pages.
- Added install section for CMake.
2020-06-13 08:07:15 +08:00
2020-08-07 17:34:05 +08:00
2020-08-23 01:19:46 +08:00
## v0.4.0 2019-12-02
2020-07-07 05:38:27 +08:00
- Support for Mac OSX, FreeBSD, NetBSD, OpenBSD, DragonFly BSD, OpenSolaris, OpenIndiana (AIX and HP-UX pending).
- Use bootid for decisions of rollback.
- Counting retired pages and extended transaction info.
- Add `MDBX_ACCEDE` flag for database opening.
- Using OFD-locks and tracking for in-process multi-opening.
- Hot backup into pipe.
- Support for cmake & amalgamated sources.
- Fastest internal sort implementation.
- New internal dirty-list implementation with lazy sorting.
- Support for lazy-sync-to-disk with polling.
- Extended key length.
- Last update transaction number for each sub-database.
- Automatic read ahead enabling/disabling.
- More auto-compactification.
- Using -fsanitize=undefined and -Wpedantic options.
- Rework page merging.
- Nested transactions.
- API description.
- Checking for non-local filesystems to avoid DB corruption.