chickadee » lmdb-lolevel » mdb-env-copy

mdb-env-copy env pathprocedure

Copy an LMDB environment to the specified path.

This function may be used to make a backup of an existing environment. No lockfile is created, since it gets recreated at need.

Note: This call can trigger significant file size growth if run in parallel with write transactions, because it employs a read-only transaction. See long-lived transactions under Caveats in the C API documentation.

env
An environment handle returned by (mdb-env-create). It must have already been opened successfully.
path
The directory in which the copy will reside. This directory must already exist and be writable but must otherwise be empty.