Function lmdb_master_sys::mdb_env_copy

source ·
pub unsafe extern "C" fn mdb_env_copy(
    env: *mut MDB_env,
    path: *const c_char,
) -> c_int
Expand description

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_sec.

§Arguments

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

§Returns

A non-zero error value on failure and 0 on success.