.\" Copyright (c) 2015,2016 Leonid Yuriev . .\" Copyright (c) 2015,2016 Peter-Service R&D LLC . .\" .\" 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 . .\" .\" --- .\" .\" Copyright 2012-2016 Howard Chu, Symas Corp. All Rights Reserved. .\" Copying restrictions apply. See COPYRIGHT/LICENSE. .TH MDB_COPY 1 "2014/06/20" "LMDB 0.9.14" .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. 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 mdb_stat (1) .SH AUTHOR Howard Chu of Symas Corporation