2023-01-16 16:24:51 +03:00
|
|
|
.\" Copyright 2021-2023 Leonid Yuriev <leo@yuriev.ru>.
|
2021-03-10 14:43:49 +03:00
|
|
|
.\" Copyright 2014-2021 Howard Chu, Symas Corp. All Rights Reserved.
|
|
|
|
|
.\" Copying restrictions apply. See COPYRIGHT/LICENSE.
|
mdbx: выпуск 0.12.8 "Владимир Уткин"
Стабилизирующий выпуск с исправлением обнаруженных ошибок и устранением недочетов,
в день 100-летия со дня рождения выдающегося советского и российского ученого и конструктора [Влади́мира Фёдоровича У́ткина](https://ru.wikipedia.org/wiki/Уткин,_Владимир_Фёдорович).
Исправления и доработки:
------------------------
- Устранение регресса/ошибки в пути обработки `put(MDBX_MULTIPLE)` при пакетном/оптовом
помещении в БД множественных значений одного ключа (aka multi-value или dupsort).
Проявление проблемы зависит от компилятора и опций оптимизации/кодогенерации, но с большой вероятностью возвращется
ошибка `MDBX_BAD_VALSIZE` (`-30781`), а в отладочных сборках срабатывает проверка `cASSERT(mc, !"Invalid key-size")`.
Сценарии приводящие к другим проявлениям на данный момент не известны.
- Реализована перезапись в `mdbx_put(MDBX_CURRENT)` всех текущих мульти-значений ключа
при отсутствии флага `MDBX_NOOVERWRITE`. Ранее в такой ситуации возвращалась ошибка `MDBX_EMULTIVAL`.
В текущем понимании новое поведение более удобно и не создаёт проблем совместимости с ранее написанным кодом.
- Добавлена возможность использовать `mdbx_cursor_get(MDBX_GET_MULTIPLE)` без предварительной установки
курсора, совмещая операцию пакетного получения данных с позиционированием курсора на передаваемый ключ.
- Микрооптимизация и рефакторинг `cursor_put_nochecklen()` в продолжение исправления
регресса/ошибки в пути обработки `put(MDBX_MULTIPLE)`.
- Уточнение формулировок в описании API, в том числе пояснений о `SIGSEGV`
и недопустимости прямого изменения данных.
Более подробная информация в [ChangeLog](https://libmdbx.dqdkfa.ru/md__change_log.html).
git diff' stat: 24 commits, 18 files changed, 624 insertions(+), 94 deletions(-)
Signed-off-by: Леонид Юрьев (Leonid Yuriev) <leo@yuriev.ru>
2023-10-17 18:16:29 +03:00
|
|
|
.TH MDBX_DROP 1 "2023-10-17" "MDBX 0.12.8"
|
2021-03-10 14:43:49 +03:00
|
|
|
.SH NAME
|
|
|
|
|
mdbx_drop \- MDBX database delete tool
|
|
|
|
|
.SH SYNOPSIS
|
|
|
|
|
.B mdbx_drop
|
|
|
|
|
[\c
|
|
|
|
|
.BR \-V ]
|
|
|
|
|
[\c
|
|
|
|
|
.BR \-d ]
|
|
|
|
|
[\c
|
|
|
|
|
.BI \-s \ subdb\fR]
|
|
|
|
|
[\c
|
|
|
|
|
.BR \-n ]
|
|
|
|
|
.BR \ dbpath
|
|
|
|
|
.SH DESCRIPTION
|
|
|
|
|
The
|
|
|
|
|
.B mdbx_drop
|
|
|
|
|
utility empties or deletes a database in the specified
|
|
|
|
|
environment.
|
|
|
|
|
.SH OPTIONS
|
|
|
|
|
.TP
|
|
|
|
|
.BR \-V
|
|
|
|
|
Write the library version number to the standard output, and exit.
|
|
|
|
|
.TP
|
|
|
|
|
.BR \-d
|
|
|
|
|
Delete the specified database, don't just empty it.
|
|
|
|
|
.TP
|
|
|
|
|
.BR \-s \ subdb
|
|
|
|
|
Operate on a specific subdatabase. If no database is specified, only the main database is dropped.
|
|
|
|
|
.TP
|
|
|
|
|
.BR \-n
|
|
|
|
|
Dump an MDBX database which does not use subdirectories.
|
|
|
|
|
This is legacy option. For now MDBX handles this automatically.
|
|
|
|
|
|
|
|
|
|
.SH DIAGNOSTICS
|
|
|
|
|
Exit status is zero if no errors occur.
|
|
|
|
|
Errors result in a non-zero exit status and
|
|
|
|
|
a diagnostic message being written to standard error.
|
|
|
|
|
.SH "SEE ALSO"
|
|
|
|
|
.BR mdbx_load (1),
|
|
|
|
|
.BR mdbx_copy (1),
|
|
|
|
|
.BR mdbx_chk (1),
|
|
|
|
|
.BR mdbx_stat (1)
|
|
|
|
|
.SH AUTHOR
|
|
|
|
|
Howard Chu of Symas Corporation <http://www.symas.com>
|