2016-06-09 18:16:28 +08:00
|
|
|
.\" Copyright (c) 2015,2016 Leonid Yuriev <leo@yuriev.ru>.
|
|
|
|
|
.\" Copyright (c) 2015,2016 Peter-Service R&D LLC <http://billing.ru/>.
|
|
|
|
|
.\"
|
|
|
|
|
.\" This file is part of ReOpenMDBX.
|
|
|
|
|
.\"
|
|
|
|
|
.\" ReOpenMDBX is free software; you can redistribute it and/or modify it under
|
|
|
|
|
.\" the terms of the GNU Affero General Public License as published by
|
|
|
|
|
.\" the Free Software Foundation; either version 3 of the License, or
|
|
|
|
|
.\" (at your option) any later version.
|
|
|
|
|
.\"
|
|
|
|
|
.\" ReOpenMDBX is distributed in the hope that it will be useful,
|
|
|
|
|
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
|
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
|
.\" GNU Affero General Public License for more details.
|
|
|
|
|
.\"
|
|
|
|
|
.\" You should have received a copy of the GNU Affero General Public License
|
|
|
|
|
.\" along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
|
.\"
|
|
|
|
|
.\" ---
|
|
|
|
|
.\"
|
|
|
|
|
.\" Copyright 2012-2014 Howard Chu, Symas Corp. All Rights Reserved.
|
2015-01-07 21:49:50 +08:00
|
|
|
.\" Copying restrictions apply. See COPYRIGHT/LICENSE.
|
2016-06-09 18:16:28 +08:00
|
|
|
.TH MDB_COPY 1 "2014/06/20" "LMDB 0.9.14"
|
2015-01-07 21:49:50 +08:00
|
|
|
.SH NAME
|
|
|
|
|
mdb_copy \- LMDB environment copy tool
|
|
|
|
|
.SH SYNOPSIS
|
|
|
|
|
.B mdb_copy
|
|
|
|
|
[\c
|
|
|
|
|
.BR \-V ]
|
|
|
|
|
[\c
|
|
|
|
|
.BR \-c ]
|
|
|
|
|
[\c
|
|
|
|
|
.BR \-n ]
|
|
|
|
|
.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.
|
2016-06-25 13:55:34 +08:00
|
|
|
Currently it fails if the environment has suffered a page leak.
|
2015-01-07 21:49:50 +08:00
|
|
|
.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 mdb_stat (1)
|
|
|
|
|
.SH AUTHOR
|
|
|
|
|
Howard Chu of Symas Corporation <http://www.symas.com>
|
