chickadee » lmdb-lolevel » mdb-env-copy2

mdb-env-copy2 env path flagsprocedure

Copy an LMDB environment to the specified path, with options.

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.
flags
Special options for this operation. This parameter must be set to 0 or by bitwise OR'ing together (using the bitwise-ior procedure) one or more of the values described in the Constants section 'Copy Flags'