2022-01-15 18:50:22 +03:00
|
|
|
.\" Copyright 2015-2022 Leonid Yuriev <leo@yuriev.ru>.
|
2017-05-24 01:07:15 +03:00
|
|
|
.\" Copyright 2012-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: release v0.12.1 (Positive Proxima)
The planned frontward release with new superior features on the day of 20 anniversary of [Positive Technologies](https://ptsecurty.com).
New:
----
- The `Big Foot` feature which significantly reduces GC overhead for processing large lists of retired pages from huge transactions.
Now _libmdbx_ avoid creating large chunks of PNLs (page number lists) which required a long sequences of free pages, aka large/overflow pages.
Thus avoiding searching, allocating and storing such sequences inside GC.
- Improved hot/online validation and checking of database pages both for more robustness and performance.
- New solid and fast method to latch meta-pages called `Troika`.
The minimum of memory barriers, reads, comparisons and conditional transitions are used.
- New `MDBX_VALIDATION` environment options to extra validation of DB structure and pages content for carefully/safe handling damaged or untrusted DB.
- Accelerated ×16/×8/×4 by AVX512/AVX2/SSE2/Neon implementations of search page sequences.
- Added the `gcrtime_seconds16dot16` counter to the "Page Operation Statistics" that accumulates time spent for GC searching and reclaiming.
- Copy-with-compactification now clears/zeroes unused gaps inside database pages.
- The `C` and `C++` APIs has been extended and/or refined to simplify using `wchar_t` pathnames.
On Windows the `mdbx_env_openW()`, `mdbx_env_get_pathW()`, `mdbx_env_copyW()`, `mdbx_env_open_for_recoveryW()` are available for now,
but the `mdbx_env_get_path()` has been replaced in favor of `mdbx_env_get_pathW()`.
- Added explicit error message for Buildroot's Microblaze toolchain maintainers.
- Added `MDBX_MANAGE_BUILD_FLAGS` build options for CMake.
- Speed-up internal `bsearch`/`lower_bound` implementation using branchless tactic, including workaround for CLANG x86 optimiser bug.
- A lot internal refinement and micro-optimisations.
- Internally counted volume of dirty pages (unused for now but for coming features).
Fixes:
------
- Never use modern `__cxa_thread_atexit()` on Apple's OSes.
- Don't check owner for finished transactions.
- Fixed typo in `MDBX_EINVAL` which breaks MingGW builds with CLANG.
37 files changed, 7604 insertions(+), 7417 deletions(-)
Signed-off-by: Леонид Юрьев (Leonid Yuriev) <leo@yuriev.ru>
2022-08-24 16:24:22 +03:00
|
|
|
.TH MDBX_STAT 1 "2022-08-24" "MDBX 0.12.1"
|
2015-01-07 16:49:50 +03:00
|
|
|
.SH NAME
|
2017-05-24 01:42:10 +03:00
|
|
|
mdbx_stat \- MDBX environment status tool
|
2015-01-07 16:49:50 +03:00
|
|
|
.SH SYNOPSIS
|
2017-02-21 20:16:54 +03:00
|
|
|
.B mdbx_stat
|
2015-01-07 16:49:50 +03:00
|
|
|
[\c
|
|
|
|
|
.BR \-V ]
|
|
|
|
|
[\c
|
2019-12-05 01:43:57 +03:00
|
|
|
.BR \-q ]
|
|
|
|
|
[\c
|
2021-05-12 14:41:09 +03:00
|
|
|
.BR \-p ]
|
|
|
|
|
[\c
|
2015-01-07 16:49:50 +03:00
|
|
|
.BR \-e ]
|
|
|
|
|
[\c
|
|
|
|
|
.BR \-f [ f [ f ]]]
|
|
|
|
|
[\c
|
|
|
|
|
.BR \-r [ r ]]
|
|
|
|
|
[\c
|
|
|
|
|
.BR \-a \ |
|
|
|
|
|
.BI \-s \ subdb\fR]
|
2019-12-05 01:43:57 +03:00
|
|
|
.BR \ dbpath
|
|
|
|
|
[\c
|
|
|
|
|
.BR \-n ]
|
2015-01-07 16:49:50 +03:00
|
|
|
.SH DESCRIPTION
|
|
|
|
|
The
|
2017-02-21 20:16:54 +03:00
|
|
|
.B mdbx_stat
|
2017-05-24 01:42:10 +03:00
|
|
|
utility displays the status of an MDBX environment.
|
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
|
2021-05-12 14:41:09 +03:00
|
|
|
.BR \-p
|
|
|
|
|
Display overall statistics of page operations of all (running, completed
|
|
|
|
|
and aborted) transactions in the current multi-process session (since the
|
|
|
|
|
first process opened the database after everyone had previously closed it).
|
|
|
|
|
.TP
|
2015-01-07 16:49:50 +03:00
|
|
|
.BR \-e
|
|
|
|
|
Display information about the database environment.
|
|
|
|
|
.TP
|
|
|
|
|
.BR \-f
|
2021-05-12 14:41:09 +03:00
|
|
|
Display information about the environment GC.
|
|
|
|
|
If \fB\-ff\fP is given, summarize each GC/freelist entry.
|
|
|
|
|
If \fB\-fff\fP is given, display the full list of page IDs in the GC/freelist.
|
2015-01-07 16:49:50 +03:00
|
|
|
.TP
|
|
|
|
|
.BR \-r
|
|
|
|
|
Display information about the environment reader table.
|
|
|
|
|
Shows the process ID, thread ID, and transaction ID for each active
|
|
|
|
|
reader slot. The process ID and transaction ID are in decimal, the
|
|
|
|
|
thread ID is in hexadecimal. The transaction ID is displayed as "-"
|
|
|
|
|
if the reader does not currently have a read transaction open.
|
|
|
|
|
If \fB\-rr\fP is given, check for stale entries in the reader
|
|
|
|
|
table and clear them. The reader table will be printed again
|
|
|
|
|
after the check is performed.
|
|
|
|
|
.TP
|
|
|
|
|
.BR \-a
|
|
|
|
|
Display the status of all of the subdatabases in the environment.
|
|
|
|
|
.TP
|
|
|
|
|
.BR \-s \ subdb
|
|
|
|
|
Display the status of a specific subdatabase.
|
2019-12-05 01:43:57 +03:00
|
|
|
.TP
|
|
|
|
|
.BR \-n
|
|
|
|
|
Display the status of an MDBX database which does not use subdirectories.
|
2020-09-28 15:37:47 +03:00
|
|
|
This is legacy option. For now MDBX handles this automatically
|
|
|
|
|
for existing databases, but may be required while creating new.
|
|
|
|
|
|
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_chk (1),
|
|
|
|
|
.BR mdbx_copy (1),
|
|
|
|
|
.BR mdbx_dump (1),
|
|
|
|
|
.BR mdbx_load (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>
|