2019-01-17 12:25:31 -07:00
|
|
|
.TH MDB_COPY 1 "2017/07/31" "LMDB 0.9.70"
|
|
|
|
|
.\" Copyright 2012-2019 Howard Chu, Symas Corp. All Rights Reserved.
|
2015-03-02 02:55:58 -07:00
|
|
|
.\" Copying restrictions apply. See COPYRIGHT/LICENSE.
|
|
|
|
|
.SH NAME
|
|
|
|
|
mdb_copy \- LMDB environment copy tool
|
|
|
|
|
.SH SYNOPSIS
|
|
|
|
|
.B mdb_copy
|
|
|
|
|
[\c
|
|
|
|
|
.BR \-V ]
|
|
|
|
|
[\c
|
|
|
|
|
.BR \-c ]
|
|
|
|
|
[\c
|
|
|
|
|
.BR \-n ]
|
2017-08-12 05:21:25 -06:00
|
|
|
[\c
|
|
|
|
|
.BR \-v ]
|
2015-03-02 02:55:58 -07:00
|
|
|
.B srcpath
|
|
|
|
|
[\c
|
|
|
|
|
.BR dstpath ]
|
|
|
|
|
.SH DESCRIPTION
|
|
|
|
|
The
|
|
|
|
|
.B mdb_copy
|
|
|
|
|
utility copies an LMDB 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 dstpath
|
|
|
|
|
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 \-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.
|
2019-01-17 12:25:31 -07:00
|
|
|
Currently it fails if the environment has suffered a page leak.
|
2015-03-02 02:55:58 -07:00
|
|
|
.TP
|
|
|
|
|
.BR \-n
|
|
|
|
|
Open LDMB environment(s) which do not use subdirectories.
|
2017-08-12 05:21:25 -06:00
|
|
|
.TP
|
|
|
|
|
.BR \-v
|
|
|
|
|
Use the previous environment state instead of the latest state.
|
|
|
|
|
This may be useful if the latest state has been corrupted.
|
2015-03-02 02:55:58 -07: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 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 mdb_stat (1)
|
|
|
|
|
.SH AUTHOR
|
|
|
|
|
Howard Chu of Symas Corporation <http://www.symas.com>
|
