mdbxmou 0.1.26

package/deps/libmdbx/src/logging_and_debug.h

@@ -0,0 +1,159 @@
+/// \copyright SPDX-License-Identifier: Apache-2.0
+/// \author Леонид Юрьев aka Leonid Yuriev <leo@yuriev.ru> \date 2015-2025
+
+#pragma once
+
+#include "essentials.h"
+
+#ifndef __Wpedantic_format_voidptr
+MDBX_MAYBE_UNUSED static inline const void *__Wpedantic_format_voidptr(const void *ptr) { return ptr; }
+#define __Wpedantic_format_voidptr(ARG) __Wpedantic_format_voidptr(ARG)
+#endif /* __Wpedantic_format_voidptr */
+
+MDBX_INTERNAL void MDBX_PRINTF_ARGS(4, 5) debug_log(int level, const char *function, int line, const char *fmt, ...)
+    MDBX_PRINTF_ARGS(4, 5);
+MDBX_INTERNAL void debug_log_va(int level, const char *function, int line, const char *fmt, va_list args);
+
+#if MDBX_DEBUG
+#define LOG_ENABLED(LVL) unlikely(LVL <= globals.loglevel)
+#define AUDIT_ENABLED() unlikely((globals.runtime_flags & (unsigned)MDBX_DBG_AUDIT))
+#else /* MDBX_DEBUG */
+#define LOG_ENABLED(LVL) (LVL < MDBX_LOG_VERBOSE && LVL <= globals.loglevel)
+#define AUDIT_ENABLED() (0)
+#endif /* LOG_ENABLED() & AUDIT_ENABLED() */
+
+#if MDBX_FORCE_ASSERTIONS
+#define ASSERT_ENABLED() (1)
+#elif MDBX_DEBUG
+#define ASSERT_ENABLED() likely((globals.runtime_flags & (unsigned)MDBX_DBG_ASSERT))
+#else
+#define ASSERT_ENABLED() (0)
+#endif /* ASSERT_ENABLED() */
+
+#define DEBUG_EXTRA(fmt, ...)                                                                                          \
+  do {                                                                                                                 \
+    if (LOG_ENABLED(MDBX_LOG_EXTRA))                                                                                   \
+      debug_log(MDBX_LOG_EXTRA, __func__, __LINE__, fmt, __VA_ARGS__);                                                 \
+  } while (0)
+
+#define DEBUG_EXTRA_PRINT(fmt, ...)                                                                                    \
+  do {                                                                                                                 \
+    if (LOG_ENABLED(MDBX_LOG_EXTRA))                                                                                   \
+      debug_log(MDBX_LOG_EXTRA, nullptr, 0, fmt, __VA_ARGS__);                                                         \
+  } while (0)
+
+#define TRACE(fmt, ...)                                                                                                \
+  do {                                                                                                                 \
+    if (LOG_ENABLED(MDBX_LOG_TRACE))                                                                                   \
+      debug_log(MDBX_LOG_TRACE, __func__, __LINE__, fmt "\n", __VA_ARGS__);                                            \
+  } while (0)
+
+#define DEBUG(fmt, ...)                                                                                                \
+  do {                                                                                                                 \
+    if (LOG_ENABLED(MDBX_LOG_DEBUG))                                                                                   \
+      debug_log(MDBX_LOG_DEBUG, __func__, __LINE__, fmt "\n", __VA_ARGS__);                                            \
+  } while (0)
+
+#define VERBOSE(fmt, ...)                                                                                              \
+  do {                                                                                                                 \
+    if (LOG_ENABLED(MDBX_LOG_VERBOSE))                                                                                 \
+      debug_log(MDBX_LOG_VERBOSE, __func__, __LINE__, fmt "\n", __VA_ARGS__);                                          \
+  } while (0)
+
+#define NOTICE(fmt, ...)                                                                                               \
+  do {                                                                                                                 \
+    if (LOG_ENABLED(MDBX_LOG_NOTICE))                                                                                  \
+      debug_log(MDBX_LOG_NOTICE, __func__, __LINE__, fmt "\n", __VA_ARGS__);                                           \
+  } while (0)
+
+#define WARNING(fmt, ...)                                                                                              \
+  do {                                                                                                                 \
+    if (LOG_ENABLED(MDBX_LOG_WARN))                                                                                    \
+      debug_log(MDBX_LOG_WARN, __func__, __LINE__, fmt "\n", __VA_ARGS__);                                             \
+  } while (0)
+
+#undef ERROR /* wingdi.h                                                                                               \
+  Yeah, morons from M$ put such definition to the public header. */
+
+#define ERROR(fmt, ...)                                                                                                \
+  do {                                                                                                                 \
+    if (LOG_ENABLED(MDBX_LOG_ERROR))                                                                                   \
+      debug_log(MDBX_LOG_ERROR, __func__, __LINE__, fmt "\n", __VA_ARGS__);                                            \
+  } while (0)
+
+#define FATAL(fmt, ...) debug_log(MDBX_LOG_FATAL, __func__, __LINE__, fmt "\n", __VA_ARGS__);
+
+#if MDBX_DEBUG
+#define ASSERT_FAIL(env, msg, func, line) mdbx_assert_fail(env, msg, func, line)
+#else /* MDBX_DEBUG */
+MDBX_NORETURN __cold void assert_fail(const char *msg, const char *func, unsigned line);
+#define ASSERT_FAIL(env, msg, func, line)                                                                              \
+  do {                                                                                                                 \
+    (void)(env);                                                                                                       \
+    assert_fail(msg, func, line);                                                                                      \
+  } while (0)
+#endif /* MDBX_DEBUG */
+
+#define ENSURE_MSG(env, expr, msg)                                                                                     \
+  do {                                                                                                                 \
+    if (unlikely(!(expr)))                                                                                             \
+      ASSERT_FAIL(env, msg, __func__, __LINE__);                                                                       \
+  } while (0)
+
+#define ENSURE(env, expr) ENSURE_MSG(env, expr, #expr)
+
+/* assert(3) variant in environment context */
+#define eASSERT(env, expr)                                                                                             \
+  do {                                                                                                                 \
+    if (ASSERT_ENABLED())                                                                                              \
+      ENSURE(env, expr);                                                                                               \
+  } while (0)
+
+/* assert(3) variant in cursor context */
+#define cASSERT(mc, expr) eASSERT((mc)->txn->env, expr)
+
+/* assert(3) variant in transaction context */
+#define tASSERT(txn, expr) eASSERT((txn)->env, expr)
+
+#ifndef xMDBX_TOOLS /* Avoid using internal eASSERT() */
+#undef assert
+#define assert(expr) eASSERT(nullptr, expr)
+#endif
+
+MDBX_MAYBE_UNUSED static inline void jitter4testing(bool tiny) {
+#if MDBX_DEBUG
+  if (globals.runtime_flags & (unsigned)MDBX_DBG_JITTER)
+    osal_jitter(tiny);
+#else
+  (void)tiny;
+#endif
+}
+
+MDBX_MAYBE_UNUSED MDBX_INTERNAL void page_list(page_t *mp);
+
+MDBX_INTERNAL const char *pagetype_caption(const uint8_t type, char buf4unknown[16]);
+/* Key size which fits in a DKBUF (debug key buffer). */
+#define DKBUF_MAX 127
+#define DKBUF char dbg_kbuf[DKBUF_MAX * 4 + 2]
+#define DKEY(x) mdbx_dump_val(x, dbg_kbuf, DKBUF_MAX * 2 + 1)
+#define DVAL(x) mdbx_dump_val(x, dbg_kbuf + DKBUF_MAX * 2 + 1, DKBUF_MAX * 2 + 1)
+
+#if MDBX_DEBUG
+#define DKBUF_DEBUG DKBUF
+#define DKEY_DEBUG(x) DKEY(x)
+#define DVAL_DEBUG(x) DVAL(x)
+#else
+#define DKBUF_DEBUG ((void)(0))
+#define DKEY_DEBUG(x) ("-")
+#define DVAL_DEBUG(x) ("-")
+#endif
+
+MDBX_INTERNAL void log_error(const int err, const char *func, unsigned line);
+
+MDBX_MAYBE_UNUSED static inline int log_if_error(const int err, const char *func, unsigned line) {
+  if (unlikely(err != MDBX_SUCCESS))
+    log_error(err, func, line);
+  return err;
+}
+
+#define LOG_IFERR(err) log_if_error((err), __func__, __LINE__)

package/deps/libmdbx/src/man1/mdbx_chk.1

@@ -0,0 +1,106 @@
+.\" Copyright 2015-2025 Leonid Yuriev <leo@yuriev.ru>.
+.\" Copying restrictions apply.  See COPYRIGHT/LICENSE.
+.TH MDBX_CHK 1 "2024-08-29" "MDBX 0.13"
+.SH NAME
+mdbx_chk \- MDBX checking tool
+.SH SYNOPSIS
+.B mdbx_chk
+[\c
+.BR \-V ]
+[\c
+.BR \-v [ v [ v ]]]
+[\c
+.BR \-n ]
+[\c
+.BR \-q ]
+[\c
+.BR \-c ]
+[\c
+.BR \-w ]
+[\c
+.BR \-d ]
+[\c
+.BR \-i ]
+[\c
+.BI \-s \ table\fR]
+.BR \ dbpath
+.SH DESCRIPTION
+The
+.B mdbx_chk
+utility is intended to check an MDBX database file.
+.SH OPTIONS
+.TP
+.BR \-V
+Write the library version number to the standard output, and exit.
+.TP
+.BR \-v
+Produce verbose output, including summarize space and page usage statistics.
+If \fB\-vv\fP is given, be more verbose, show summarized B-tree info
+and space allocation.
+If \fB\-vvv\fP is given, be more verbose, include summarized statistics
+of leaf B-tree pages.
+If \fB\-vvvv\fP is given, be even more verbose, show info of each page
+during B-tree traversal and basic info of each GC record.
+If \fB\-vvvvv\fP is given, turn maximal verbosity, display the full list
+of page IDs in the GC records and size of each key-value pair of database(s).
+.TP
+.BR \-q
+Be quiet; do not output anything even if an error was detected.
+.TP
+.BR \-c
+Force using cooperative mode while opening environment, i.e. don't try to open
+in exclusive/monopolistic mode. Only exclusive/monopolistic mode allow complete
+check, including full check of all meta-pages and actual size of database file.
+.TP
+.BR \-w
+Open environment in read-write mode and lock for writing while checking.
+This could be impossible if environment already used by another process(s)
+in an incompatible read-write mode. This allows rollback to last steady commit
+(in case environment was not closed properly) and then check transaction IDs
+of meta-pages. Otherwise, without \fB\-w\fP option environment will be
+opened in read-only mode.
+.TP
+.BR \-d
+Disable page-by-page traversal of B-tree. In this case, without B-tree
+traversal, it is unable to check for lost-unused pages nor for double-used
+pages.
+.TP
+.BR \-i
+Ignore wrong order errors, which will likely false-positive if custom
+comparator(s) was used.
+.TP
+.BR \-s \ table
+Verify and show info only for a specific table.
+.TP
+.BR \-0 | \-1 | \-2
+Using specific meta-page 0, or 2 for checking.
+.TP
+.BR \-t
+Turn to a specified meta-page on successful check.
+.TP
+.BR \-T
+Turn to a specified meta-page EVEN ON UNSUCCESSFUL CHECK!
+.TP
+.BR \-u
+Warms up the DB before checking via notifying OS kernel of subsequent access to the database pages.
+.TP
+.BR \-U
+Warms up the DB before checking, notifying the OS kernel of subsequent access to the database pages,
+then forcibly loads ones by sequential access and tries to lock database pages in memory.
+.TP
+.BR \-n
+Open MDBX environment(s) which do not use subdirectories.
+This is a 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
+if no quiet mode was requested.
+.SH "SEE ALSO"
+.BR mdbx_stat (1),
+.BR mdbx_copy (1),
+.BR mdbx_dump (1),
+.BR mdbx_load (1)
+.BR mdbx_drop (1)
+.SH AUTHOR
+Leonid Yuriev <https://gitflic.ru/user/erthink>

package/deps/libmdbx/src/man1/mdbx_copy.1

@@ -0,0 +1,95 @@
+.\" Copyright 2015-2025 Leonid Yuriev <leo@yuriev.ru>.
+.\" Copyright 2015,2016 Peter-Service R&D LLC <http://billing.ru/>.
+.\" Copyright 2012-2015 Howard Chu, Symas Corp. All Rights Reserved.
+.\" Copying restrictions apply.  See COPYRIGHT/LICENSE.
+.TH MDBX_COPY 1 "2024-08-29" "MDBX 0.13"
+.SH NAME
+mdbx_copy \- MDBX environment copy tool
+.SH SYNOPSIS
+.B mdbx_copy
+[\c
+.BR \-V ]
+[\c
+.BR \-q ]
+[\c
+.BR \-c ]
+[\c
+.BR \-d ]
+[\c
+.BR \-p ]
+[\c
+.BR \-n ]
+.B src_path
+[\c
+.BR dest_path ]
+.SH DESCRIPTION
+The
+.B mdbx_copy
+utility copies an MDBX environment. The environment can
+be copied regardless of whether it is currently in use.
+No lockfile is created, since it gets recreated at need.
+
+If
+.I dest_path
+is specified it must be the path of an empty directory
+for storing the backup. Otherwise, the backup will be
+written to stdout.
+
+.SH OPTIONS
+.TP
+.BR \-V
+Write the library version number to the standard output, and exit.
+.TP
+.BR \-q
+Be quiet.
+.TP
+.BR \-c
+Compact while copying. Only current data pages will be copied; freed
+or unused pages will be omitted from the copy. This option will
+slow down the backup process as it is more CPU-intensive.
+Currently it fails if the environment has suffered a page leak.
+.TP
+.BR \-d
+Alters geometry to enforce the copy to be a dynamic size DB,
+which could be growth and shrink by reasonable steps on the fly.
+.TP
+.BR \-p
+Use read transaction parking/ousting during copying MVCC-snapshot.
+This allows the writing transaction to oust the read
+transaction used to copy the database if copying takes so long
+that it will interfere with the recycling old MVCC snapshots
+and may lead to an overflow of the database.
+However, if the reading transaction is ousted the copy will
+be aborted until successful completion. Thus, this option
+allows copy the database without interfering with write
+transactions and a threat of database overflow, but at the cost
+that copying will be aborted to prevent such conditions.
+.TP
+.BR \-u
+Warms up the DB before copying via notifying OS kernel of subsequent access to the database pages.
+.TP
+.BR \-U
+Warms up the DB before copying, notifying the OS kernel of subsequent access to the database pages,
+then forcibly loads ones by sequential access and tries to lock database pages in memory.
+.TP
+.BR \-n
+Open MDBX environment(s) which do 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 CAVEATS
+This utility can trigger significant file size growth if run
+in parallel with write transactions, because pages which they
+free during copying cannot be reused until the copy is done.
+.SH "SEE ALSO"
+.BR mdbx_dump (1),
+.BR mdbx_chk (1),
+.BR mdbx_stat (1),
+.BR mdbx_load (1)
+.BR mdbx_drop (1)
+.SH AUTHOR
+Howard Chu of Symas Corporation <http://www.symas.com>,
+Leonid Yuriev <https://gitflic.ru/user/erthink>

package/deps/libmdbx/src/man1/mdbx_drop.1

@@ -0,0 +1,48 @@
+.\" Copyright 2021-2025 Leonid Yuriev <leo@yuriev.ru>.
+.\" Copyright 2014-2021 Howard Chu, Symas Corp. All Rights Reserved.
+.\" Copying restrictions apply.  See COPYRIGHT/LICENSE.
+.TH MDBX_DROP 1 "2024-08-29" "MDBX 0.13"
+.SH NAME
+mdbx_drop \- MDBX database delete tool
+.SH SYNOPSIS
+.B mdbx_drop
+[\c
+.BR \-V ]
+[\c
+.BR \-d ]
+[\c
+.BI \-s \ table\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 \ table
+Operate on a specific table. If no table is specified, only the main table 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>

package/deps/libmdbx/src/man1/mdbx_dump.1

@@ -0,0 +1,101 @@
+.\" Copyright 2015-2025 Leonid Yuriev <leo@yuriev.ru>.
+.\" Copyright 2015,2016 Peter-Service R&D LLC <http://billing.ru/>.
+.\" Copyright 2014-2015 Howard Chu, Symas Corp. All Rights Reserved.
+.\" Copying restrictions apply.  See COPYRIGHT/LICENSE.
+.TH MDBX_DUMP 1 "2024-08-29" "MDBX 0.13"
+.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 \ table\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 tables in the environment.
+.TP
+.BR \-s \ table
+Dump a specific table. If no database is specified, only the main table is dumped.
+.TP
+.BR \-r
+Rescure mode. Ignore some errors to dump corrupted DB.
+.TP
+.BR \-u
+Warms up the DB before dumping via notifying OS kernel of subsequent access to the database pages.
+.TP
+.BR \-U
+Warms up the DB before dumping, notifying the OS kernel of subsequent access to the database pages,
+then forcibly loads ones by sequential access and tries to lock database pages in memory.
+.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://gitflic.ru/user/erthink>

package/deps/libmdbx/src/man1/mdbx_load.1

@@ -0,0 +1,105 @@
+.\" Copyright 2015-2025 Leonid Yuriev <leo@yuriev.ru>.
+.\" Copyright 2015,2016 Peter-Service R&D LLC <http://billing.ru/>.
+.\" Copyright 2014-2015 Howard Chu, Symas Corp. All Rights Reserved.
+.\" Copying restrictions apply.  See COPYRIGHT/LICENSE.
+.TH MDBX_LOAD 1 "2024-08-29" "MDBX 0.13"
+.SH NAME
+mdbx_load \- MDBX environment import tool
+.SH SYNOPSIS
+.B mdbx_load
+[\c
+.BR \-V ]
+[\c
+.BR \-q ]
+[\c
+.BR \-a ]
+[\c
+.BI \-f \ file\fR]
+[\c
+.BI \-s \ table\fR]
+[\c
+.BR \-N ]
+[\c
+.BR \-T ]
+[\c
+.BR \-r ]
+[\c
+.BR \-n ]
+.BR \ dbpath
+.SH DESCRIPTION
+The
+.B mdbx_load
+utility reads from the standard input and loads it into the
+MDBX environment
+.BR dbpath .
+
+The input to
+.B mdbx_load
+must be in the output format specified by the
+.BR mdbx_dump (1)
+utility or as specified by the
+.B -T
+option below.
+
+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 .
+
+.SH OPTIONS
+.TP
+.BR \-V
+Write the library version number to the standard output, and exit.
+.TP
+.BR \-q
+Be quiet.
+.TP
+.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
+.BR \-f \ file
+Read from the specified file instead of from the standard input.
+.TP
+.BR \-s \ table
+Load a specific table. If no table is specified, data is loaded into the main table.
+.TP
+.BR \-N
+Don't overwrite existing records when loading into an already existing table; 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.
+.TP
+.BR \-r
+Rescure mode. Ignore errors to load corrupted DB dump.
+.TP
+.BR \-n
+Load 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_dump (1),
+.BR mdbx_chk (1),
+.BR mdbx_stat (1),
+.BR mdbx_copy (1)
+.BR mdbx_drop (1)
+.SH AUTHOR
+Howard Chu of Symas Corporation <http://www.symas.com>,
+Leonid Yuriev <https://gitflic.ru/user/erthink>

package/deps/libmdbx/src/man1/mdbx_stat.1

@@ -0,0 +1,86 @@
+.\" Copyright 2015-2025 Leonid Yuriev <leo@yuriev.ru>.
+.\" Copyright 2015,2016 Peter-Service R&D LLC <http://billing.ru/>.
+.\" Copyright 2012-2015 Howard Chu, Symas Corp. All Rights Reserved.
+.\" Copying restrictions apply.  See COPYRIGHT/LICENSE.
+.TH MDBX_STAT 1 "2024-08-29" "MDBX 0.13"
+.SH NAME
+mdbx_stat \- MDBX environment status tool
+.SH SYNOPSIS
+.B mdbx_stat
+[\c
+.BR \-V ]
+[\c
+.BR \-q ]
+[\c
+.BR \-p ]
+[\c
+.BR \-e ]
+[\c
+.BR \-f [ f [ f ]]]
+[\c
+.BR \-r [ r ]]
+[\c
+.BR \-a \ |
+.BI \-s \ table\fR]
+.BR \ dbpath
+[\c
+.BR \-n ]
+.SH DESCRIPTION
+The
+.B mdbx_stat
+utility displays the status of an MDBX environment.
+.SH OPTIONS
+.TP
+.BR \-V
+Write the library version number to the standard output, and exit.
+.TP
+.BR \-q
+Be quiet.
+.TP
+.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
+.BR \-e
+Display information about the database environment.
+.TP
+.BR \-f
+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.
+.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 tables in the environment.
+.TP
+.BR \-s \ table
+Display the status of a specific table.
+.TP
+.BR \-n
+Display the status of an MDBX database which does not use subdirectories.
+This is legacy option. For now MDBX handles this automatically
+for existing databases, but may be required while creating new.
+
+.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_chk (1),
+.BR mdbx_copy (1),
+.BR mdbx_dump (1),
+.BR mdbx_load (1)
+.BR mdbx_drop (1)
+.SH AUTHOR
+Howard Chu of Symas Corporation <http://www.symas.com>,
+Leonid Yuriev <https://gitflic.ru/user/erthink>