MDB\_COPY(1) General Commands Manual MDB\_COPY(1)

# [NAME](#NAME)

mdb\_copy - LMDB environment copy tool

# [SYNOPSIS](#SYNOPSIS)

**mdb\_copy** \[**-V**] \[**-c**] \[**-n**] **srcpath** \[**dstpath**]

# [DESCRIPTION](#DESCRIPTION)

The **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 *dstpath* is specified it must be the path of an empty directory for storing the backup. Otherwise, the backup will be written to stdout.

# [OPTIONS](#OPTIONS)

[**-V**](#V)

Write the library version number to the standard output, and exit.

[**-c**](#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.

[**-n**](#n)

Open LDMB environment(s) which do not use subdirectories.

# [DIAGNOSTICS](#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.

# [CAVEATS](#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.

# [SEE ALSO](#SEE_ALSO)

[**mdb\_stat**(1)](/man/os/lmdb/mdb_stat.1)

# [AUTHOR](#AUTHOR)

Howard Chu of Symas Corporation <http://www.symas.com>

2014/07/01 LMDB 0.9.14

---

Document: mdb_copy(1) from lmdb 0.9.35-r2 (Chainguard OS)
Source: https://github.com/LMDB/lmdb.git