mirror of
https://github.com/isar/libmdbx.git
synced 2025-04-16 01:37:46 +08:00
daa7f04f61
The stable release with fixes for large and huge databases sized of 4..128 TiB. Acknowledgements: ----------------- - Ledgerwatch, Binance and Positive Technologies teams for reporting, assistance in investigation and testing. - Alex Sharov for reporting, testing and provide resources for remote debugging/investigation. - Kris Zyp for Deno support. New features, extensions and improvements: ------------------------------------------ - Added treating the `UINT64_MAX` value as maximum for given option inside `mdbx_env_set_option()`. - Added `to_hex/to_base58/to_base64::output(std::ostream&)` overloads without using temporary string objects as buffers. - Added `--geometry-jitter=YES|no` option to the test framework. - Added support for [Deno](https://deno.land/) support by [Kris Zyp](https://github.com/kriszyp). Fixes: ------ - Fixed handling `MDBX_opt_rp_augment_limit` for GC's records from huge transactions (Erigon/Akula/Ethereum). - [Fixed](https://github.com/erthink/libmdbx/issues/258) build on Android (avoid including `sys/sem.h`). - [Fixed](https://github.com/erthink/libmdbx/pull/261) missing copy assignment operator for `mdbx::move_result`. - Fixed missing `&` for `std::ostream &operator<<()` overloads. - Fixed unexpected `EXDEV` (Cross-device link) error from `mdbx_env_copy()`. - Fixed base64 encoding/decoding bugs in auxillary C++ API. - Fixed overflow of `pgno_t` during checking PNL on 64-bit platforms. - [Fixed](https://github.com/erthink/libmdbx/issues/260) excessive PNL checking after sort for spilling. - Reworked checking `MAX_PAGENO` and DB upper-size geometry limit. - [Fixed](https://github.com/erthink/libmdbx/issues/265) build for some combinations of versions of MSVC and Windows SDK. Minors: ------- - Added workaround for CLANG bug [D79919/PR42445](https://reviews.llvm.org/D79919). - Fixed build test on Android (using `pthread_barrier_t` stub). - Disabled C++20 concepts for CLANG < 14 on Android. - Fixed minor `unused parameter` warning. - Added CI for Android. - Refine/cleanup internal logging. - Refined line splitting inside hex/base58/base64 encoding to avoid `\n` at the end. - Added workaround for modern libstdc++ with CLANG < 4.x - Relaxed txn-check rules for auxiliary functions. - Clarified a comments and descriptions, etc. - Using the `-fno-semantic interposition` option to reduce the overhead to calling self own public functions. Signed-off-by: Леонид Юрьев (Leonid Yuriev) <leo@yuriev.ru>
95 lines
2.6 KiB
Groff
95 lines
2.6 KiB
Groff
.\" Copyright 2015-2022 Leonid Yuriev <leo@yuriev.ru>.
|
|
.\" Copyright 2014-2015 Howard Chu, Symas Corp. All Rights Reserved.
|
|
.\" Copyright 2015,2016 Peter-Service R&D LLC <http://billing.ru/>.
|
|
.\" Copying restrictions apply. See COPYRIGHT/LICENSE.
|
|
.TH MDBX_DUMP 1 "2022-02-02" "MDBX 0.11.4"
|
|
.SH NAME
|
|
mdbx_dump \- MDBX environment export tool
|
|
.SH SYNOPSIS
|
|
.B mdbx_dump
|
|
[\c
|
|
.BR \-V ]
|
|
[\c
|
|
.BR \-q ]
|
|
[\c
|
|
.BI \-f \ file\fR]
|
|
[\c
|
|
.BR \-l ]
|
|
[\c
|
|
.BR \-p ]
|
|
[\c
|
|
.BR \-a \ |
|
|
.BI \-s \ subdb\fR]
|
|
[\c
|
|
.BR \-r ]
|
|
[\c
|
|
.BR \-n ]
|
|
.BR \ dbpath
|
|
.SH DESCRIPTION
|
|
The
|
|
.B mdbx_dump
|
|
utility reads a database and writes its contents to the
|
|
standard output using a portable flat-text format
|
|
understood by the
|
|
.BR mdbx_load (1)
|
|
utility.
|
|
.SH OPTIONS
|
|
.TP
|
|
.BR \-V
|
|
Write the library version number to the standard output, and exit.
|
|
.TP
|
|
.BR \-q
|
|
Be quiet.
|
|
.TP
|
|
.BR \-f \ file
|
|
Write to the specified file instead of to the standard output.
|
|
.TP
|
|
.BR \-l
|
|
List the databases stored in the environment. Just the
|
|
names will be listed, no data will be output.
|
|
.TP
|
|
.BR \-p
|
|
If characters in either the key or data items are printing characters (as
|
|
defined by isprint(3)), output them directly. This option permits users to
|
|
use standard text editors and tools to modify the contents of databases.
|
|
|
|
Note: different systems may have different notions about what characters
|
|
are considered printing characters, and databases dumped in this manner may
|
|
be less portable to external systems.
|
|
.TP
|
|
.BR \-a
|
|
Dump all of the subdatabases in the environment.
|
|
.TP
|
|
.BR \-s \ subdb
|
|
Dump a specific subdatabase. If no database is specified, only the main database is dumped.
|
|
.TP
|
|
.BR \-r
|
|
Rescure mode. Ignore some errors to dump corrupted DB.
|
|
.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.
|
|
|
|
Dumping and reloading databases that use user-defined comparison functions
|
|
will result in new databases that use the default comparison functions.
|
|
\fBIn this case it is quite likely that the reloaded database will be
|
|
damaged beyond repair permitting neither record storage nor retrieval.\fP
|
|
|
|
The only available workaround is to modify the source for the
|
|
.BR mdbx_load (1)
|
|
utility to load the database using the correct comparison functions.
|
|
.SH "SEE ALSO"
|
|
.BR mdbx_load (1),
|
|
.BR mdbx_copy (1),
|
|
.BR mdbx_chk (1),
|
|
.BR mdbx_stat (1)
|
|
.BR mdbx_drop (1)
|
|
.SH AUTHOR
|
|
Howard Chu of Symas Corporation <http://www.symas.com>,
|
|
Leonid Yuriev <https://github.com/erthink>
|