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

   1 .TH MDB_COPY 1 "2014/06/20" "LMDB 0.9.14"
   2 .\" Copyright 2012-2014 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 [\c
   9 .BR \-V ]
  10 [\c
  11 .BR \-n ]
  12 .B srcpath
  13 [\c
  14 .BR dstpath ]
  15 .SH DESCRIPTION
  16 The
  17 .B mdb_copy
  18 utility copies an LMDB environment. The environment can
  19 be copied regardless of whether it is currently in use.
  20 No lockfile is created, since it gets recreated at need.
  21
  22 If
  23 .I dstpath
  24 is specified it must be the path of an empty directory
  25 for storing the backup. Otherwise, the backup will be
  26 written to stdout.
  27
  28 .SH OPTIONS
  29 .TP
  30 .BR \-V
  31 Write the library version number to the standard output, and exit.
  32 .TP
  33 .BR \-n
  34 Open LDMB environment(s) which do not use subdirectories.
  35
  36 .SH DIAGNOSTICS
  37 Exit status is zero if no errors occur.
  38 Errors result in a non-zero exit status and
  39 a diagnostic message being written to standard error.
  40 .SH CAVEATS
  41 This utility can trigger significant file size growth if run
  42 in parallel with write transactions, because pages which they
  43 free during copying cannot be reused until the copy is done.
  44 .SH "SEE ALSO"
  45 .BR mdb_stat (1)
  46 .SH AUTHOR
  47 Howard Chu of Symas Corporation <http://www.symas.com>