mirror of
https://github.com/isar/libmdbx.git
synced 2024-12-30 01:34:14 +08:00
58 lines
1.6 KiB
Groff
58 lines
1.6 KiB
Groff
.\" Copyright 2015-2017 Leonid Yuriev <leo@yuriev.ru>.
|
|
.\" Copyright 2012-2017 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 MDB_COPY 1 "2014/06/20" "LMDB 0.9.14"
|
|
.SH NAME
|
|
mdbx_copy \- LMDB environment copy tool
|
|
.SH SYNOPSIS
|
|
.B mdbx_copy
|
|
[\c
|
|
.BR \-V ]
|
|
[\c
|
|
.BR \-c ]
|
|
[\c
|
|
.BR \-n ]
|
|
.B srcpath
|
|
[\c
|
|
.BR dstpath ]
|
|
.SH DESCRIPTION
|
|
The
|
|
.B mdbx_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.
|
|
Currently it fails if the environment has suffered a page leak.
|
|
.TP
|
|
.BR \-n
|
|
Open LDMB environment(s) which do not use subdirectories.
|
|
|
|
.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_stat (1)
|
|
.SH AUTHOR
|
|
Howard Chu of Symas Corporation <http://www.symas.com>
|