git.sur5r.net Git - openldap/blob - libraries/liblmdb/mdb_copy.1

   1 .TH MDB_COPY 1 "2012/12/12" "LMDB 0.9.5"
   2 .\" Copyright 2012 Howard Chu, Symas Corp. All Rights Reserved.
   3 .\" Copying restrictions apply.  See COPYRIGHT/LICENSE.
   4 .SH NAME
   5 mdb_copy \- LMDB environment copy tool
   6 .SH SYNOPSIS
   7 .B mdb_copy
   8 .I srcpath\ [dstpath]
   9 .SH DESCRIPTION
  10 The
  11 .B mdb_copy
  12 utility copies an LMDB environment. The environment can
  13 be copied regardless of whether it is currently in use.
  14 No lockfile is created, since it gets recreated at need.
  15
  16 If
  17 .I dstpath
  18 is specified it must be the path of an empty directory
  19 for storing the backup. Otherwise, the backup will be
  20 written to stdout.
  21
  22 .SH DIAGNOSTICS
  23 Exit status is zero if no errors occur.
  24 Errors result in a non-zero exit status and
  25 a diagnostic message being written to standard error.
  26 .SH CAVEATS
  27 This utility can trigger significant file size growth if run
  28 in parallel with write transactions, because pages which they
  29 free during copying cannot be reused until the copy is done.
  30 .SH "SEE ALSO"
  31 .BR mdb_stat (1)
  32 .SH AUTHOR
  33 Howard Chu of Symas Corporation <http://www.symas.com>