libmdbx/TODO.md

TODO
----

Unfortunately, on 2022-04-15 the Github administration, without any
warning nor explanation, deleted _libmdbx_ along with a lot of other
projects, simultaneously blocking access for many developers. Therefore
on 2022-04-21 we have migrated to a reliable trusted infrastructure.
The origin for now is at[GitFlic](https://gitflic.ru/project/erthink/libmdbx)
with backup at [ABF by ROSA Лаб](https://abf.rosalinux.ru/erthink/libmdbx).
For the same reason ~~Github~~ is blacklisted forever.

So currently most of the links are broken due to noted malicious ~~Github~~ sabotage.

 - SWING.
 - Параллельная lto-сборка с устранением предупреждений.
 - Интеграция c DTrace и аналогами.
 - Новый стиль обработки ошибок с записью "трассы" и причин.
 - Формирование отладочной информации посредством gdb.
 - Поддержка WASM.
 - Рефакторинг gc-get/gc-put c переходом на "интервальные" списки.
 - Ранняя/не-отложенная очистка GC.
 - Явная и автоматические уплотнение/дефрагментация.
 - Нелинейная обработка GC.
 - Перевести курсоры на двусвязный список вместо односвязного.
 - Внутри `txn_renew()` вынести проверку когерентности mmap за/после изменение размера.
 - [Migration guide from LMDB to MDBX](https://libmdbx.dqdkfa.ru/dead-github/issues/199).
 - [Support for RAW devices](https://libmdbx.dqdkfa.ru/dead-github/issues/124).
 - [Support MessagePack for Keys & Values](https://libmdbx.dqdkfa.ru/dead-github/issues/115).
 - Packages for [Astra Linux](https://astralinux.ru/), [ALT Linux](https://www.altlinux.org/), [ROSA Linux](https://www.rosalinux.ru/), etc.

Done
----

 - [Engage new terminology](https://libmdbx.dqdkfa.ru/dead-github/issues/137).
 - [More flexible support of asynchronous runtime/framework(s)](https://libmdbx.dqdkfa.ru/dead-github/issues/200).
 - [Move most of `mdbx_chk` functional to the library API](https://libmdbx.dqdkfa.ru/dead-github/issues/204).
 - [Simple careful mode for working with corrupted DB](https://libmdbx.dqdkfa.ru/dead-github/issues/223).
 - [Engage an "overlapped I/O" on Windows](https://libmdbx.dqdkfa.ru/dead-github/issues/224).
 - [Large/Overflow pages accounting for dirty-room](https://libmdbx.dqdkfa.ru/dead-github/issues/192).
 - [Get rid of dirty-pages list in MDBX_WRITEMAP mode](https://libmdbx.dqdkfa.ru/dead-github/issues/193).

Cancelled
--------

 - [Replace SRW-lock on Windows to allow shrink DB with `MDBX_NOSTICKYTHREADS` option](https://libmdbx.dqdkfa.ru/dead-github/issues/210).
   Доработка не может быть реализована, так как замена SRW-блокировки
   лишает лишь предварительную проблему, но не главную. На Windows
   уменьшение размера отображенного в память файла не поддерживается ядром
   ОС. Для этого необходимо снять отображение, изменить размер файла и
   затем отобразить обратно. В свою очередь, для это необходимо
   приостановить работающие с БД потоки выполняющие транзакции чтения, либо
   готовые к такому выполнению. Но в режиме MDBX_NOSTICKYTHREADS нет
   возможности отслеживать работающие с БД потоки, а приостановка всех
   потоков неприемлема для большинства приложений.
-												mdbx: split-out `TODO.md` from `ChangeLog.md`.

											
										
										
											2022-04-23 14:11:18 +03:00
+								TODO
 								----
 								Unfortunately, on 2022-04-15 the Github administration, without any
 								warning nor explanation, deleted _libmdbx_ along with a lot of other
 								projects, simultaneously blocking access for many developers. Therefore
 								on 2022-04-21 we have migrated to a reliable trusted infrastructure.
 								The origin for now is at[GitFlic](https://gitflic.ru/project/erthink/libmdbx)
-												mdbx: use `abf.rosalinux.ru` instead of `abf.io`.

											
										
										
											2022-04-25 12:52:29 +03:00
+								with backup at [ABF by ROSA Лаб](https://abf.rosalinux.ru/erthink/libmdbx).
-												mdbx: split-out `TODO.md` from `ChangeLog.md`.

											
										
										
											2022-04-23 14:11:18 +03:00
+								For the same reason ~~Github~~ is blacklisted forever.
 								So currently most of the links are broken due to noted malicious ~~Github~~ sabotage.
-												mdbx: дополнение TODO.

											
										
										
											2025-01-26 15:54:34 +03:00
+								 - SWING.
 								 - Параллельная lto-сборка с устранением предупреждений.
 								 - Интеграция c DTrace и аналогами.
 								 - Новый стиль обработки ошибок с записью "трассы" и причин.
 								 - Формирование отладочной информации посредством gdb.
 								 - Поддержка WASM.
 								 - Рефакторинг gc-get/gc-put c переходом на "интервальные" списки.
-												mdbx-doc: дополнение TODO.

											
										
										
											2025-01-21 16:26:47 +03:00
+								 - Ранняя/не-отложенная очистка GC.
-												mdbx: дополнение TODO.

											
										
										
											2025-01-26 15:54:34 +03:00
+								 - Явная и автоматические уплотнение/дефрагментация.
-												mdbx-doc: дополнение TODO.

											
										
										
											2025-01-21 16:26:47 +03:00
+								 - Нелинейная обработка GC.
-												mdbx: дополнение TODO.

											
										
										
											2025-01-26 15:54:34 +03:00
+								 - Перевести курсоры на двусвязный список вместо односвязного.
-												mdbx: устранение возможности `SIGSEGV` внутри `coherency_check()`.

Падение происходило в случае когда:

 - Некоторый процесс увеличивал размер БД с изменением геометрии (с
   увеличением предельного размера БД и её отображения в ОЗУ), затем
   задействовал страницу из добавленного сегмента в качестве корневой для
   FreeDB/GC и/или MainDB и фиксировал транзакцию.

 - Другой процесс, уже работавший с БД до изменения геометрии первым
   процессом, запускал транзакцию чтения. Падение происходило при проверке
   «когерентности» отображения страниц БД в ОЗУ, при проверке отметок
   модификации внутри корневых страниц, так как в этом случае они были вне
   границ текущего отображения БД в адресном пространстве этого процесса.

Похоже что в ходе какого-то рефакторинга потерялась соответствующая
проверка. Этот коммит добавляет её как временное решение, до переноса
проверки «когерентности» после изменения размера отображения (добавлено в
TODO).

											
										
										
											2024-08-07 17:38:53 +03:00
+								 - Внутри `txn_renew()` вынести проверку когерентности mmap за/после изменение размера.
-												mdbx: использование https://libmdbx.dqdkfa.ru/dead-github для удаленных issues.

											
										
										
											2022-11-23 01:18:25 +03:00
+								 - [Migration guide from LMDB to MDBX](https://libmdbx.dqdkfa.ru/dead-github/issues/199).
 								 - [Support for RAW devices](https://libmdbx.dqdkfa.ru/dead-github/issues/124).
 								 - [Support MessagePack for Keys & Values](https://libmdbx.dqdkfa.ru/dead-github/issues/115).
-												mdbx: split-out `TODO.md` from `ChangeLog.md`.

											
										
										
											2022-04-23 14:11:18 +03:00
+								 - Packages for [Astra Linux](https://astralinux.ru/), [ALT Linux](https://www.altlinux.org/), [ROSA Linux](https://www.rosalinux.ru/), etc.
-												mdbx: extend descriptions for `MDBX_VALIDATION` and update TODO for done item.

											
										
										
											2022-07-09 19:40:09 +03:00
 								Done
 								----
-												mdbx: использование термина "таблица" вместо "sub-database".

											
										
										
											2024-08-03 13:25:44 +03:00
+								 - [Engage new terminology](https://libmdbx.dqdkfa.ru/dead-github/issues/137).
-												mdbx: добавление режима `MDBX_NOSTICKYTHREADS` вместо `MDBX_NOTLS`.

											
										
										
											2024-04-02 00:22:09 +03:00
+								 - [More flexible support of asynchronous runtime/framework(s)](https://libmdbx.dqdkfa.ru/dead-github/issues/200).
-												mdbx: переработка и перенос функционала утилиты `mdbx_chk` внутрь библиотеки.

											
										
										
											2023-04-24 20:59:18 +03:00
+								 - [Move most of `mdbx_chk` functional to the library API](https://libmdbx.dqdkfa.ru/dead-github/issues/204).
-												mdbx: использование https://libmdbx.dqdkfa.ru/dead-github для удаленных issues.

											
										
										
											2022-11-23 01:18:25 +03:00
+								 - [Simple careful mode for working with corrupted DB](https://libmdbx.dqdkfa.ru/dead-github/issues/223).
 								 - [Engage an "overlapped I/O" on Windows](https://libmdbx.dqdkfa.ru/dead-github/issues/224).
 								 - [Large/Overflow pages accounting for dirty-room](https://libmdbx.dqdkfa.ru/dead-github/issues/192).
 								 - [Get rid of dirty-pages list in MDBX_WRITEMAP mode](https://libmdbx.dqdkfa.ru/dead-github/issues/193).
-												mdbx: обновление TODO.

											
										
										
											2024-04-04 22:31:03 +03:00
-												mdbx: исправление опечатки/орфографии.

											
										
										
											2024-09-08 20:48:44 +03:00
+								Cancelled
-												mdbx: обновление TODO.

											
										
										
											2024-04-04 22:31:03 +03:00
+								--------
 								 - [Replace SRW-lock on Windows to allow shrink DB with `MDBX_NOSTICKYTHREADS` option](https://libmdbx.dqdkfa.ru/dead-github/issues/210).
 								   Доработка не может быть реализована, так как замена SRW-блокировки
 								   лишает лишь предварительную проблему, но не главную. На Windows
 								   уменьшение размера отображенного в память файла не поддерживается ядром
 								   ОС. Для этого необходимо снять отображение, изменить размер файла и
 								   затем отобразить обратно. В свою очередь, для это необходимо
 								   приостановить работающие с БД потоки выполняющие транзакции чтения, либо
-												mdbx: использование термина "таблица" вместо "sub-database".

											
										
										
											2024-08-03 13:25:44 +03:00
+								   готовые к такому выполнению. Но в режиме MDBX_NOSTICKYTHREADS нет
-												mdbx: обновление TODO.

											
										
										
											2024-04-04 22:31:03 +03:00
+								   возможности отслеживать работающие с БД потоки, а приостановка всех
 								   потоков неприемлема для большинства приложений.