2023-01-16 16:24:51 +03:00
|
|
|
.\" Copyright 2015-2023 Leonid Yuriev <leo@yuriev.ru>.
|
2017-05-24 01:07:15 +03:00
|
|
|
.\" Copyright 2014-2015 Howard Chu, Symas Corp. All Rights Reserved.
|
2017-01-01 14:56:00 +03:00
|
|
|
.\" Copyright 2015,2016 Peter-Service R&D LLC <http://billing.ru/>.
|
2015-01-07 16:49:50 +03:00
|
|
|
.\" Copying restrictions apply. See COPYRIGHT/LICENSE.
|
mdbx: выпуск 0.12.4 "Арта-333"
Стабилизирующий выпуск с исправлением обнаруженных ошибок, устранением
недочетов и технических долгов. Ветка 0.12 считается готовой к
продуктовому использованию, получает статус стабильной и далее будет
получать только исправление ошибок. Разработка будет продолжена в ветке
0.13, а ветка 0.11 становится архивной.
Благодарности:
--------------
- Max <maxc0d3r@protonmail.com> за сообщение о проблеме ERROR_SHARING_VIOLATION
в режиме MDBX_EXCLUSIVE на Windows.
- Alisher Ashyrov <https://t.me/a1is43ras4> за сообщение о проблеме
с assert-проверкой и содействие в отладке.
- Masatoshi Fukunaga <https://gitflic.ru/user/mah0x211> за сообщение о проблеме
`put(MDBX_UPSERT+MDBX_ALLDUPS)` для случая замены всех значений в subDb.
Исправления (без корректировок новых функций):
----------------------------------------------
- Устранен регресс после коммита 474391c83c5f81def6fdf3b0b6f5716a87b78fbf,
приводящий к возврату ERROR_SHARING_VIOLATION в Windows при открытии БД
в режиме MDBX_EXCLUSIVE для чтения-записи.
- Добавлено ограничение размера отображения при коротком read-only файле, для
предотвращения ошибки ERROR_NOT_ENOUGH_MEMORY в Windows, которая возникает
в этом случае и совсем не информативна для пользователя.
- Произведен рефакторинг `dxb_resize()`, в том числе, для устранения срабатывания
assert-проверки `size_bytes == env->me_dxb_mmap.current` в специфических
многопоточных сценариях использования. Проверка срабатывала только в
отладочных сборках, при специфическом наложении во времени читающей и
пишущей транзакции в разных потоках, одновременно с изменением размера БД.
Кроме срабатывание проверки, каких-либо других последствий не возникало.
- Устранена проблема в `put(MDBX_UPSERT+MDBX_ALLDUPS)` для случая замены
всех значений единственного ключа в subDb. В ходе этой операции subDb
становится полностью пустой, без каких-либо страниц и именно эта
ситуация не была учтена в коде, что приводило к повреждению БД
при фиксации такой транзакции.
- Устранена излишняя assert-проверка внутри `override_meta()`.
Что в отладочных сборках могло приводить к ложным срабатываниям
при восстановлении БД, в том числе при автоматическом откате слабых
мета-страниц.
- Скорректированы макросы `__cold`/`__hot`, в том числе для устранения проблемы
`error: inlining failed in call to ‘always_inline FOO(...)’: target specific option mismatch`
при сборке посредством GCC >10.x для SH4.
Ликвидация технических долгов и мелочи:
---------------------------------------
- Исправлены многочисленные опечатки в документации.
- Доработан тест для полной стохастической проверки `MDBX_EKEYMISMATCH` в режиме `MDBX_APPEND`.
- Расширены сценарии запуска `mdbx_chk` из CMake-тестов для проверки как в обычном,
так и эксклюзивном режимах чтения-записи.
- Уточнены спецификаторы `const` и `noexcept` для нескольких методов в C++ API.
- Устранено использование стека под буферы для `wchar`-преобразования путей.
- Для Windows добавлена функция `mdbx_env_get_path()` для получения пути к БД
в формате многобайтных символов.
- Добавлены doxygen-описания для API с широкими символами.
- Устранены предупреждения статического анализатора MSVC,
все они были несущественные, либо ложные.
- Устранено ложное предупреждение GCC при сборке для SH4.
- Добавлена поддержка ASAN (Address Sanitizer) при сборке посредством MSVC.
- Расширен набор перебираемых режимов в скрипте `test/long_stochastic.sh`,
добавлена опция `--extra`.
- В C++ API добавлена поддержка расширенных опций времени выполнения `mdbx::extra_runtime_option`,
аналогично `enum MDBX_option_t` из C API.
- Вывод всех счетчиков page-operations в `mdbx_stat`.
63 files changed, 1161 insertions(+), 569 deletions(-)
Signed-off-by: Леонид Юрьев (Leonid Yuriev) <leo@yuriev.ru>
2023-03-03 23:23:08 +03:00
|
|
|
.TH MDBX_LOAD 1 "2023-03-03" "MDBX 0.12.4"
|
2015-01-07 16:49:50 +03:00
|
|
|
.SH NAME
|
2017-05-24 01:42:10 +03:00
|
|
|
mdbx_load \- MDBX environment import tool
|
2015-01-07 16:49:50 +03:00
|
|
|
.SH SYNOPSIS
|
2017-02-21 20:16:54 +03:00
|
|
|
.B mdbx_load
|
2015-01-07 16:49:50 +03:00
|
|
|
[\c
|
|
|
|
|
.BR \-V ]
|
|
|
|
|
[\c
|
2019-12-05 01:43:57 +03:00
|
|
|
.BR \-q ]
|
2015-01-07 16:49:50 +03:00
|
|
|
[\c
|
2019-12-05 01:43:57 +03:00
|
|
|
.BR \-a ]
|
|
|
|
|
[\c
|
|
|
|
|
.BI \-f \ file\fR]
|
2015-01-07 16:49:50 +03:00
|
|
|
[\c
|
|
|
|
|
.BI \-s \ subdb\fR]
|
|
|
|
|
[\c
|
|
|
|
|
.BR \-N ]
|
|
|
|
|
[\c
|
|
|
|
|
.BR \-T ]
|
2019-12-05 01:43:57 +03:00
|
|
|
[\c
|
|
|
|
|
.BR \-r ]
|
|
|
|
|
[\c
|
|
|
|
|
.BR \-n ]
|
|
|
|
|
.BR \ dbpath
|
2015-01-07 16:49:50 +03:00
|
|
|
.SH DESCRIPTION
|
|
|
|
|
The
|
2017-02-21 20:16:54 +03:00
|
|
|
.B mdbx_load
|
2015-01-07 16:49:50 +03:00
|
|
|
utility reads from the standard input and loads it into the
|
2017-05-24 01:42:10 +03:00
|
|
|
MDBX environment
|
2019-12-05 01:43:57 +03:00
|
|
|
.BR dbpath .
|
2015-01-07 16:49:50 +03:00
|
|
|
|
|
|
|
|
The input to
|
2017-02-21 20:16:54 +03:00
|
|
|
.B mdbx_load
|
2015-01-07 16:49:50 +03:00
|
|
|
must be in the output format specified by the
|
2017-02-21 20:16:54 +03:00
|
|
|
.BR mdbx_dump (1)
|
2015-01-07 16:49:50 +03:00
|
|
|
utility or as specified by the
|
|
|
|
|
.B -T
|
|
|
|
|
option below.
|
2020-09-25 02:10:55 +03:00
|
|
|
|
|
|
|
|
A simple escape mechanism, where newline and backslash (\\) characters are special, is
|
|
|
|
|
applied to the text input. Newline characters are interpreted as record separators.
|
|
|
|
|
Backslash characters in the text will be interpreted in one of two ways: If the backslash
|
|
|
|
|
character precedes another backslash character, the pair will be interpreted as a literal
|
|
|
|
|
backslash. If the backslash character precedes any other character, the two characters
|
|
|
|
|
following the backslash will be interpreted as a hexadecimal specification of a single
|
|
|
|
|
character; for example, \\0a is a newline character in the ASCII character set.
|
|
|
|
|
|
|
|
|
|
For this reason, any backslash or newline characters that naturally occur in the text
|
|
|
|
|
input must be escaped to avoid misinterpretation by
|
|
|
|
|
.BR mdbx_load .
|
|
|
|
|
|
2015-01-07 16:49:50 +03:00
|
|
|
.SH OPTIONS
|
|
|
|
|
.TP
|
|
|
|
|
.BR \-V
|
|
|
|
|
Write the library version number to the standard output, and exit.
|
|
|
|
|
.TP
|
2019-12-05 01:43:57 +03:00
|
|
|
.BR \-q
|
|
|
|
|
Be quiet.
|
|
|
|
|
.TP
|
2019-02-03 15:49:40 +03:00
|
|
|
.BR \-a
|
|
|
|
|
Append all records in the order they appear in the input. The input is assumed to already be
|
|
|
|
|
in correctly sorted order and no sorting or checking for redundant values will be performed.
|
|
|
|
|
This option must be used to reload data that was produced by running
|
|
|
|
|
.B mdbx_dump
|
|
|
|
|
on a database that uses custom compare functions.
|
|
|
|
|
.TP
|
2015-01-07 16:49:50 +03:00
|
|
|
.BR \-f \ file
|
|
|
|
|
Read from the specified file instead of from the standard input.
|
|
|
|
|
.TP
|
|
|
|
|
.BR \-s \ subdb
|
|
|
|
|
Load a specific subdatabase. If no database is specified, data is loaded into the main database.
|
|
|
|
|
.TP
|
|
|
|
|
.BR \-N
|
|
|
|
|
Don't overwrite existing records when loading into an already existing database; just skip them.
|
|
|
|
|
.TP
|
|
|
|
|
.BR \-T
|
|
|
|
|
Load data from simple text files. The input must be paired lines of text, where the first
|
|
|
|
|
line of the pair is the key item, and the second line of the pair is its corresponding
|
|
|
|
|
data item.
|
2019-12-05 01:43:57 +03:00
|
|
|
.TP
|
|
|
|
|
.BR \-r
|
|
|
|
|
Rescure mode. Ignore errors to load corrupted DB dump.
|
|
|
|
|
.TP
|
|
|
|
|
.BR \-n
|
|
|
|
|
Load an MDBX database which does not use subdirectories.
|
2020-09-25 02:10:55 +03:00
|
|
|
This is legacy option. For now MDBX handles this automatically.
|
2020-09-28 15:37:47 +03:00
|
|
|
|
2015-01-07 16:49:50 +03:00
|
|
|
.SH DIAGNOSTICS
|
|
|
|
|
Exit status is zero if no errors occur.
|
|
|
|
|
Errors result in a non-zero exit status and
|
|
|
|
|
a diagnostic message being written to standard error.
|
|
|
|
|
|
|
|
|
|
.SH "SEE ALSO"
|
2019-09-10 16:08:21 +03:00
|
|
|
.BR mdbx_dump (1),
|
|
|
|
|
.BR mdbx_chk (1),
|
|
|
|
|
.BR mdbx_stat (1),
|
|
|
|
|
.BR mdbx_copy (1)
|
2021-03-10 14:43:49 +03:00
|
|
|
.BR mdbx_drop (1)
|
2015-01-07 16:49:50 +03:00
|
|
|
.SH AUTHOR
|
2019-12-05 01:43:57 +03:00
|
|
|
Howard Chu of Symas Corporation <http://www.symas.com>,
|
2022-04-20 06:42:16 +03:00
|
|
|
Leonid Yuriev <https://gitflic.ru/user/erthink>
|