mdb_stat.1 1.74 KB
Newer Older
Howard Chu's avatar
Howard Chu committed
1
.TH MDB_STAT 1 "2015/09/30" "LMDB 0.9.17"
Quanah Gibson-Mount's avatar
Quanah Gibson-Mount committed
2
.\" Copyright 2012-2021 Howard Chu, Symas Corp. All Rights Reserved.
Howard Chu's avatar
Howard Chu committed
3
4
5
6
7
8
.\" Copying restrictions apply.  See COPYRIGHT/LICENSE.
.SH NAME
mdb_stat \- LMDB environment status tool
.SH SYNOPSIS
.B mdb_stat
[\c
Howard Chu's avatar
Howard Chu committed
9
10
.BR \-V ]
[\c
Howard Chu's avatar
Howard Chu committed
11
12
.BR \-e ]
[\c
13
.BR \-f [ f [ f ]]]
Howard Chu's avatar
Howard Chu committed
14
15
16
[\c
.BR \-n ]
[\c
Howard Chu's avatar
Howard Chu committed
17
.BR \-r [ r ]]
Howard Chu's avatar
Howard Chu committed
18
[\c
Howard Chu's avatar
Howard Chu committed
19
20
.BR \-a \ |
.BI \-s \ subdb\fR]
Howard Chu's avatar
Howard Chu committed
21
.BR \ envpath
Howard Chu's avatar
Howard Chu committed
22
23
24
25
26
27
.SH DESCRIPTION
The
.B mdb_stat
utility displays the status of an LMDB environment.
.SH OPTIONS
.TP
Howard Chu's avatar
Howard Chu committed
28
29
30
.BR \-V
Write the library version number to the standard output, and exit.
.TP
Howard Chu's avatar
Howard Chu committed
31
32
33
34
.BR \-e
Display information about the database environment.
.TP
.BR \-f
35
36
37
Display information about the environment freelist.
If \fB\-ff\fP is given, summarize each freelist entry.
If \fB\-fff\fP is given, display the full list of page IDs in the freelist.
Howard Chu's avatar
Howard Chu committed
38
39
40
41
.TP
.BR \-n
Display the status of an LMDB database which does not use subdirectories.
.TP
Howard Chu's avatar
Howard Chu committed
42
43
44
45
46
47
.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.
Howard Chu's avatar
Howard Chu committed
48
49
50
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.
Howard Chu's avatar
Howard Chu committed
51
.TP
Howard Chu's avatar
Howard Chu committed
52
53
54
55
56
57
58
59
60
61
62
63
64
.BR \-a
Display the status of all of the subdatabases in the environment.
.TP
.BR \-s \ subdb
Display the status of a specific subdatabase.
.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 mdb_copy (1)
.SH AUTHOR
Howard Chu of Symas Corporation <http://www.symas.com>