@ohos-ports/lmdb 2.5.3 → 2.8.5-beta.0

package/dependencies/lmdb/libraries/liblmdb/mdb.c

@@ -1276,7 +1276,7 @@ typedef struct MDB_db {
 #define PERSISTENT_FLAGS	(0xffff & ~(MDB_VALID))
 	/** #mdb_dbi_open() flags */
 #define VALID_FLAGS	(MDB_REVERSEKEY|MDB_DUPSORT|MDB_INTEGERKEY|MDB_DUPFIXED|\
-	MDB_INTEGERDUP|MDB_REVERSEDUP|MDB_CREATE)
+	MDB_INTEGERDUP|MDB_REVERSEDUP|MDB_CREATE|0x100)
 
 	/** Handle for the DB used to track free pages. */
 #define	FREE_DBI	0
@@ -1378,6 +1378,9 @@ struct MDB_txn {
 	 *	#mt_workid, then grows as it is copied from children who commit.
 	 */
 	txnid_t		mt_last_workid;
+	/** Callback function for when the transaction is visible */
+	MDB_txn_visible* mt_callback;
+	void* mt_ctx;
 
 	MDB_env		*mt_env;		/**< the DB environment */
 	/** The list of pages that became unused during this transaction.
@@ -1689,7 +1692,7 @@ struct MDB_env {
 #endif
 	void		*me_userctx;	 /**< User-settable context */
 	MDB_assert_func *me_assert_func; /**< Callback for assertion failures */
-	MDB_check_fd *me_check_fd; /**< Callback for assertion failures */
+	void *me_callback; /**< General callback */
 	int64_t 	boot_id;
 };
 
@@ -1861,6 +1864,8 @@ static char *const mdb_errstr[] = {
 	"MDB_BAD_CHECKSUM: Page checksum mismatch",
 	"MDB_CRYPTO_FAIL: Page encryption or decryption failed",
 	"MDB_ENV_ENCRYPTION: Environment encryption mismatch",
+	"MDB_LOCK_FAILURE: Failed to get robust semaphore, increase max semaphore count by running 'sudo sysctl kern.sysv.semume=200' or build with robust mutexes disabled (see docs)",
+	"MDB_EMPTY_TXN: Transaction was empty",
 };
 //<lmdb-js>
 static char* last_error = NULL;
@@ -1924,7 +1929,7 @@ mdb_strerror(int err)
 	buf[0] = 0;
 	FormatMessageA(FORMAT_MESSAGE_FROM_SYSTEM |
 		FORMAT_MESSAGE_IGNORE_INSERTS,
-		NULL, err, 0, ptr, MSGSIZE, (va_list *)buf+MSGSIZE);
+		NULL, err, 0, ptr, MSGSIZE, (va_list *)NULL);
 	return ptr;
 #else
 	if (last_error) {
@@ -3066,12 +3071,29 @@ fail:
 	return rc;
 }
 
+#ifdef _WIN32
+uint64_t get_time64() {
+    return GetTickCount64();
+}
+#else
+uint64_t get_time64() {
+    struct timespec time;
+    clock_gettime(CLOCK_MONOTONIC, &time);
+    return time.tv_sec * 1000000000ll + time.tv_nsec;
+}
+#endif
+
 int
 mdb_env_sync0(MDB_env *env, int force, pgno_t numpgs)
 {
 	int rc = 0;
 	if (env->me_flags & MDB_RDONLY)
 		return EACCES;
+	uint64_t start = 0;
+	if (env->me_flags & MDB_TRACK_METRICS) {
+		start = get_time64();
+	}
+
 	if (force || !(env->me_flags & MDB_NOSYNC)
 #ifdef _WIN32	/* Sync is normally achieved in Windows by doing WRITE_THROUGH writes */
 	 && (env->me_flags & MDB_WRITEMAP)
@@ -3097,6 +3119,9 @@ mdb_env_sync0(MDB_env *env, int force, pgno_t numpgs)
 				rc = ErrCode();
 		}
 	}
+	if (env->me_flags & MDB_TRACK_METRICS) {
+		((MDB_metrics*) env->me_userctx)->time_sync += get_time64() - start;
+	}
 	return rc;
 }
 
@@ -3364,6 +3389,9 @@ mdb_txn_renew0(MDB_txn *txn)
 
 	} else {
 		/* Not yet touching txn == env->me_txn0, it may be active */
+		if (env->me_flags & MDB_TRACK_METRICS) {
+			((MDB_metrics*) env->me_userctx)->clock_txn = get_time64();
+		}
 		if (ti) {
 			if (LOCK_MUTEX(rc, env, env->me_wmutex))
 				return rc;
@@ -3373,6 +3401,11 @@ mdb_txn_renew0(MDB_txn *txn)
 			meta = mdb_env_pick_meta(env);
 			txn->mt_txnid = meta->mm_txnid;
 		}
+		if (env->me_flags & MDB_TRACK_METRICS) {
+			uint64_t now = get_time64();
+			((MDB_metrics*) env->me_userctx)->time_start_txns += now - ((MDB_metrics*) env->me_userctx)->clock_txn;
+			((MDB_metrics*) env->me_userctx)->clock_txn = now;
+		}
 		txn->mt_txnid++;
 #if MDB_DEBUG
 		if (txn->mt_txnid == mdb_debug_start)
@@ -3496,6 +3529,16 @@ mdb_workid_rewind(MDB_txn *txn)
 	return workid;
 }
 
+int ESECT
+mdb_txn_set_callback(MDB_txn *txn, MDB_txn_visible *func, void* ctx)
+{
+	if (!txn)
+		return EINVAL;
+	txn->mt_callback = func;
+	txn->mt_ctx = ctx;
+	return MDB_SUCCESS;
+}
+
 int
 mdb_txn_begin(MDB_env *env, MDB_txn *parent, unsigned int flags, MDB_txn **ret)
 {
@@ -3605,6 +3648,7 @@ mdb_txn_begin(MDB_env *env, MDB_txn *parent, unsigned int flags, MDB_txn **ret)
 renew:
 		rc = mdb_txn_renew0(txn);
 	}
+	txn->mt_callback = NULL;
 	if (rc) {
 		if (txn != env->me_txn0) {
 #if MDB_RPAGE_CACHE
@@ -3841,7 +3885,6 @@ mdb_freelist_save(MDB_txn *txn)
 		unsigned x;
 		if ((rc = mdb_midl_need(&txn->mt_free_pgs, txn->mt_loose_count)) != 0)
 			return rc;
-		lost_loose = txn->mt_loose_count;
 		for (; mp; mp = NEXT_LOOSE_PAGE(mp)) {
 			mdb_midl_xappend(txn->mt_free_pgs, mp->mp_pgno);
 			/* must also remove from dirty list */
@@ -4068,10 +4111,14 @@ mdb_page_flush(MDB_txn *txn, int keep)
 	MDB_OFF_T	pos = 0;
 	pgno_t		pgno = 0;
 	MDB_page	*dp = NULL;
+	uint64_t		start = 0;
+	int			write_i = 0;
+	if (env->me_flags & MDB_TRACK_METRICS) {
+		start = get_time64();
+	}
 #ifdef _WIN32
 	OVERLAPPED	*ov, *this_ov;
 	MDB_page	*wdp;
-	int async_i = 0;
 	HANDLE fd = (txn->mt_flags & MDB_NOSYNC) ? env->me_fd : env->me_ovfd;
 #else
 	struct iovec iov[MDB_COMMIT_PAGES];
@@ -4089,13 +4136,18 @@ mdb_page_flush(MDB_txn *txn, int keep)
 
 	/* setup nump list, flag that it's in use */
 	dl_nump = env->me_dirty_nump;
+	/* <lmdb-js addition> */
 	for (n=1; n<=pagecount; n++) {
 		dp = dl[n].mptr;
 		dl_nump[n] = IS_OVERFLOW(dp) ? dp->mp_pages : 1;
+		pgno_t p = dl[n].mid + dl_nump[n];
+		if (p > pgno)
+			pgno = p;
+		else
+			fprintf(stderr, "Page writes are out of order\n");
 	}
 	txn->mt_flags |= MDB_TXN_DIRTYNUM;
 	/* <lmdb-js addition> */
-	pgno = dl[pagecount].mid + dl_nump[pagecount];
 	n = 0;
 	
 #ifdef _WIN32
@@ -4112,7 +4164,8 @@ mdb_page_flush(MDB_txn *txn, int keep)
 				rc = SetEndOfFile(fd);
 				if (!rc) {
 					rc = ErrCode();
-					fprintf(stderr, "SetEndOfFile error %s\n", strerror(rc));
+					if (rc != 1224) // occassionaly see a ERROR_USER_MAPPED_FILE with no apparent ill-effect
+						fprintf(stderr, "SetEndOfFile error, extending to %u %i %s\n", file_size, rc, strerror(rc));
 				}
 			}
 		}
@@ -4191,7 +4244,7 @@ retry_write:
 				rc = 0;
 				/* Write previous page(s) */
 #ifdef _WIN32
-				this_ov = &ov[async_i];
+				this_ov = &ov[write_i];
 				/* Clear status, and keep hEvent, we reuse that */
 				this_ov->Internal = 0;
 				this_ov->Offset = wpos & 0xffffffff;
@@ -4213,7 +4266,6 @@ retry_write:
 					}
 					rc = 0;
 				}
-				async_i++;
 #else /* _WIN32 */
 #ifdef MDB_USE_PWRITEV
 				wres = pwritev(fd, iov, n, wpos);
@@ -4246,6 +4298,7 @@ retry_seek:
 					}
 				}
 #endif /* _WIN32 */
+				write_i++;
 				if (rc)
 					return rc;
 				n = 0;
@@ -4293,6 +4346,11 @@ retry_seek:
 	 * flushed.
 	 */
 	CACHEFLUSH(env->me_map, txn->mt_next_pgno * env->me_psize, DCACHE);
+	if (env->me_flags & MDB_TRACK_METRICS) {
+		((MDB_metrics*) env->me_userctx)->writes += write_i;
+		((MDB_metrics*) env->me_userctx)->page_flushes++;
+		((MDB_metrics*) env->me_userctx)->pages_written += pagecount - keep;
+	}
 
 #ifdef _WIN32
 	if (!(txn->mt_flags & MDB_NOSYNC)) {
@@ -4301,9 +4359,9 @@ retry_seek:
 		* we reduce thread suspend/resuming (in practice, typically about 99.5% of writes are
 		* done after the last write is done) */
 		rc = 0;
-		while (--async_i >= 0) {
-			if (ov[async_i].hEvent) {
-				if (!GetOverlappedResult(fd, &ov[async_i], &wres, TRUE)) {
+		while (--write_i >= 0) {
+			if (ov[write_i].hEvent) {
+				if (!GetOverlappedResult(fd, &ov[write_i], &wres, TRUE)) {
 					rc = ErrCode(); /* Continue on so that all the event signals are reset */
 				}
 			}
@@ -4334,7 +4392,9 @@ done:
 	i--;
 	txn->mt_dirty_room += i - j;
 	dl[0].mid = j;
-
+	if (env->me_flags & MDB_TRACK_METRICS) {
+		((MDB_metrics*) env->me_userctx)->time_page_flushes += get_time64() - start;
+	}
 	return MDB_SUCCESS;
 }
 
@@ -4514,8 +4574,10 @@ mdb_txn_commit(MDB_txn *txn)
 	mdb_cursors_close(txn, 0);
 
 	if (!txn->mt_u.dirty_list[0].mid &&
-		!(txn->mt_flags & (MDB_TXN_DIRTY|MDB_TXN_SPILLS)))
-		goto done;
+		!(txn->mt_flags & (MDB_TXN_DIRTY | MDB_TXN_SPILLS))) {
+		mdb_txn_end(txn, end_mode);
+		return MDB_EMPTY_TXN;
+	}
 
 	DPRINTF(("committing txn %"Yu" %p on mdbenv %p, root page %"Yu,
 	    txn->mt_txnid, (void*)txn, (void*)env, txn->mt_dbs[MAIN_DBI].md_root));
@@ -4554,7 +4616,7 @@ mdb_txn_commit(MDB_txn *txn)
 #if (MDB_DEBUG) > 2
 	mdb_audit(txn);
 #endif
-
+	int dirty_pages = txn->mt_u.dirty_list[0].mid;
 	if ((rc = mdb_page_flush(txn, 0)))
 		goto fail;
 	if ((unsigned)txn->mt_loose_count < txn->mt_u.dirty_list[0].mid) {
@@ -4579,6 +4641,11 @@ mdb_txn_commit(MDB_txn *txn)
 		goto fail;
 
 	//<lmdb-js>
+	if (txn->mt_callback) {
+		MDB_txn_visible* callback = txn->mt_callback;
+		callback(txn->mt_ctx);
+		txn->mt_callback = NULL;
+	}
 	if (!F_ISSET(txn->mt_flags, MDB_TXN_NOSYNC))
 		env->me_synced_txn_id = txn->mt_txnid;
 	//</lmdb-js>
@@ -4594,7 +4661,43 @@ mdb_txn_commit(MDB_txn *txn)
 	}
 
 done:
-	mdb_txn_end(txn, end_mode);
+	//<lmdb-js>
+	if (env->me_flags & MDB_TRACK_METRICS) {
+		((MDB_metrics*) env->me_userctx)->time_during_txns += get_time64() - ((MDB_metrics*) env->me_userctx)->clock_txn;
+		((MDB_metrics*) env->me_userctx)->txns++;
+	}
+	if ((txn->mt_flags & MDB_NOSYNC) && (env->me_flags & MDB_OVERLAPPINGSYNC)) {
+		MDB_txn sync_txn;
+		MDB_db dbs[2];
+		sync_txn.mt_env = env;
+		sync_txn.mt_flags = 2;
+		sync_txn.mt_dbs = dbs;
+		sync_txn.mt_dbs[FREE_DBI] = txn->mt_dbs[FREE_DBI];
+		sync_txn.mt_dbs[MAIN_DBI] = txn->mt_dbs[MAIN_DBI];
+		sync_txn.mt_dbs[FREE_DBI].md_flags &= ~MDB_OVERLAPPINGSYNC; // clear this to indicate it is flushed txn
+		sync_txn.mt_txnid = txn->mt_txnid;
+		sync_txn.mt_next_pgno = txn->mt_next_pgno;
+		if (dirty_pages * (txn->mt_txnid - env->me_synced_txn_id) > 100) {
+			// for bigger txns we wait for the flush before allowing next txn
+			LOCK_MUTEX(rc, env, env->me_sync_mutex);
+			mdb_txn_end(txn, end_mode);
+		} else {
+			mdb_txn_end(txn, end_mode);
+			LOCK_MUTEX(rc, env, env->me_sync_mutex);
+		}
+		if (rc)
+			return rc;
+		rc = mdb_env_sync0(env, 0, sync_txn.mt_next_pgno);
+		if (rc) {
+			UNLOCK_MUTEX(env->me_sync_mutex);
+			return rc;
+		}
+		rc = mdb_env_write_meta(&sync_txn);
+		if (rc == 0)
+			env->me_synced_txn_id = sync_txn.mt_txnid;
+		UNLOCK_MUTEX(env->me_sync_mutex);
+	} else
+		mdb_txn_end(txn, end_mode);
 	return MDB_SUCCESS;
 
 fail:
@@ -4725,7 +4828,7 @@ mdb_env_init_meta0(MDB_env *env, MDB_meta *meta)
 	meta->mm_mapsize = env->me_mapsize;
 	meta->mm_psize = env->me_psize;
 	meta->mm_last_pg = NUM_METAS-1;
-	meta->mm_flags = env->me_flags & 0xffff;
+	meta->mm_flags = env->me_flags & 0xffff & ~MDB_OVERLAPPINGSYNC;
 	meta->mm_flags |= MDB_INTEGERKEY; /* this is mm_dbs[FREE_DBI].md_flags */
 	meta->mm_dbs[FREE_DBI].md_root = P_INVALID;
 	meta->mm_dbs[MAIN_DBI].md_root = P_INVALID;
@@ -5871,10 +5974,10 @@ mdb_env_setup_locks(MDB_env *env, MDB_name *fname, int mode, int *excl)
 #endif
 	int rc;
 	MDB_OFF_T size, rsize;
-	if (env->me_check_fd) {
+	if (env->me_callback) {
 		rc = mdb_fopen(env, fname, MDB_O_RDWR, mode, &env->me_lfd);
 		if (!rc) {
-			rc = ((MDB_check_fd*) env->me_check_fd)(env->me_lfd, env);
+			rc = ((MDB_check_fd*) env->me_callback)(env->me_lfd, env);
 			if (rc)
 				return rc;
 		}
@@ -6011,11 +6114,11 @@ mdb_env_setup_locks(MDB_env *env, MDB_name *fname, int mode, int *excl)
 		env->me_sync_mutex = sem_open(MUTEXNAME(env, 's'), O_CREAT|O_EXCL, mode, 1);
 		if (env->me_sync_mutex == SEM_FAILED) goto fail_errno;
 #elif defined(MDB_USE_SYSV_SEM)
-		unsigned short vals[2] = {1, 1};
+		unsigned short vals[3] = {1, 1, 1};
 		key_t key = ftok(fname->mn_val, 'M'); /* fname is lockfile path now */
 		if (key == -1)
 			goto fail_errno;
-		semid = semget(key, 2, (mode & 0777) | IPC_CREAT);
+		semid = semget(key, 3, (mode & 0777) | IPC_CREAT);
 		if (semid < 0)
 			goto fail_errno;
 		semu.array = vals;
@@ -6040,7 +6143,7 @@ mdb_env_setup_locks(MDB_env *env, MDB_name *fname, int mode, int *excl)
 			goto fail;
 		rc = pthread_mutexattr_setpshared(&mattr, PTHREAD_PROCESS_SHARED);
 #ifdef MDB_ROBUST_SUPPORTED
-		if (!rc) rc = pthread_mutexattr_setrobust(&mattr, PTHREAD_MUTEX_ROBUST);
+		if (!rc) pthread_mutexattr_setrobust(&mattr, PTHREAD_MUTEX_ROBUST); // don't record rc, we don't care if it fails
 #endif
 		if (!rc) rc = pthread_mutex_init(env->me_txns->mti_rmutex, &mattr);
 		if (!rc) rc = pthread_mutex_init(env->me_txns->mti_wmutex, &mattr);
@@ -6187,7 +6290,7 @@ mdb_env_envflags(MDB_env *env)
 	 */
 #define	CHANGEABLE	(MDB_NOSYNC|MDB_NOMETASYNC|MDB_MAPASYNC|MDB_NOMEMINIT)
 #define	CHANGELESS	(MDB_FIXEDMAP|MDB_NOSUBDIR|MDB_RDONLY| \
-	MDB_WRITEMAP|MDB_NOTLS|MDB_NOLOCK|MDB_NORDAHEAD|MDB_PREVSNAPSHOT|MDB_REMAP_CHUNKS|MDB_OVERLAPPINGSYNC|MDB_SAFE_RESTORE)
+	MDB_WRITEMAP|MDB_NOTLS|MDB_NOLOCK|MDB_NORDAHEAD|MDB_PREVSNAPSHOT|MDB_REMAP_CHUNKS|MDB_OVERLAPPINGSYNC|MDB_SAFE_RESTORE|MDB_TRACK_METRICS)
 #define EXPOSED		(CHANGEABLE|CHANGELESS | MDB_ENCRYPT)
 
 #if VALID_FLAGS & PERSISTENT_FLAGS & EXPOSED
@@ -6412,6 +6515,8 @@ mdb_env_open(MDB_env *env, const char *path, unsigned int flags, mdb_mode_t mode
 				txn->mt_dbxs = env->me_dbxs;
 				txn->mt_flags = MDB_TXN_FINISHED;
 				env->me_txn0 = txn;
+				MDB_meta* latest = mdb_env_pick_meta(env);
+				txn->mt_env->me_synced_txn_id = latest->mm_txnid;
 			} else {
 				rc = ENOMEM;
 			}
@@ -7769,6 +7874,12 @@ mdb_node_read(MDB_cursor *mc, MDB_node *leaf, MDB_val *data)
 int
 mdb_get(MDB_txn *txn, MDB_dbi dbi,
     MDB_val *key, MDB_val *data)
+{
+	return mdb_get_with_txn(txn, dbi, key, data, NULL);
+}
+int
+mdb_get_with_txn(MDB_txn *txn, MDB_dbi dbi,
+    MDB_val *key, MDB_val *data, mdb_size_t *txn_id)
 {
 	MDB_cursor	mc;
 	MDB_xcursor	mx;
@@ -7805,6 +7916,9 @@ mdb_get(MDB_txn *txn, MDB_dbi dbi,
 	/* unref all the pages when MDB_REMAP_CHUNKS - caller must copy the data
 	 * before doing anything else
 	 */
+	if (txn_id && !rc) {
+		*txn_id = mc.mc_pg[mc.mc_top]->mp_txnid;
+	}
 	MDB_CURSOR_UNREF(&mc, 1);
 	return rc;
 }
@@ -8893,6 +9007,7 @@ current:
 				 * is smaller than the overflow threshold.
 				 */
 				if (!IS_WRITABLE(mc->mc_txn, omp)) {
+
 				  if (!IS_DIRTY_NW(mc->mc_txn, omp)) {
 					rc = mdb_page_unspill(mc->mc_txn, omp, &omp);
 					if (rc)
@@ -10590,7 +10705,10 @@ mdb_del(MDB_txn *txn, MDB_dbi dbi,
 		/* must ignore any data */
 		data = NULL;
 	}
-
+	MDB_env* env = txn->mt_env;
+	if (env->me_flags & MDB_TRACK_METRICS) {
+		((MDB_metrics*) env->me_userctx)->deletes++;
+	}
 	return mdb_del0(txn, dbi, key, data, 0);
 }
 
@@ -11082,6 +11200,10 @@ mdb_put(MDB_txn *txn, MDB_dbi dbi,
 
 	if (txn->mt_flags & (MDB_TXN_RDONLY|MDB_TXN_BLOCKED))
 		return (txn->mt_flags & MDB_TXN_RDONLY) ? EACCES : MDB_BAD_TXN;
+	MDB_env* env = txn->mt_env;
+	if (env->me_flags & MDB_TRACK_METRICS) {
+		((MDB_metrics*) env->me_userctx)->puts++;
+	}
 
 	mdb_cursor_init(&mc, txn, dbi, &mx);
 	mc.mc_next = txn->mt_cursors[dbi];
@@ -11477,7 +11599,7 @@ mdb_env_copyfd1(MDB_env *env, HANDLE fd)
 		mm->mm_dbs[MAIN_DBI].md_flags = txn->mt_dbs[MAIN_DBI].md_flags;
 	}
 	if (root != P_INVALID || mm->mm_dbs[MAIN_DBI].md_flags) {
-		mm->mm_txnid = 1;		/* use metapage 1 */
+		mm->mm_txnid = txn->mt_txnid | 1;		/* update to current txn id and make it odd*/
 	}
 
 	my.mc_wlen[0] = env->me_psize * NUM_METAS;
@@ -11676,7 +11798,8 @@ mdb_env_set_userctx(MDB_env *env, void *ctx)
 {
 	if (!env)
 		return EINVAL;
-	env->me_userctx = ctx;
+	if (ctx)
+		env->me_userctx = ctx;
 	return MDB_SUCCESS;
 }
 
@@ -11698,11 +11821,11 @@ mdb_env_set_assert(MDB_env *env, MDB_assert_func *func)
 }
 
 int ESECT
-mdb_env_set_check_fd(MDB_env *env, MDB_check_fd *func)
+mdb_env_set_callback(MDB_env *env, MDB_check_fd *func)
 {
 	if (!env)
 		return EINVAL;
-	env->me_check_fd = func;
+	env->me_callback = func;
 	return MDB_SUCCESS;
 }
 
@@ -11817,7 +11940,7 @@ mdb_env_info(MDB_env *env, MDB_envinfo *arg)
 		return EINVAL;
 
 	meta = mdb_env_pick_meta(env);
-	arg->me_mapaddr = meta->mm_address;
+	arg->me_mapaddr = env->me_map;
 	arg->me_last_pgno = meta->mm_last_pg;
 	arg->me_last_txnid = meta->mm_txnid;
 
@@ -12394,7 +12517,10 @@ mdb_mutex_failed(MDB_env *env, mdb_mutexref_t mutex, int rc)
 #endif
 		DPRINTF(("LOCK_MUTEX failed, %s", mdb_strerror(rc)));
 	}
-
+#ifdef __APPLE__
+	if (rc == EINVAL)
+		rc = MDB_LOCK_FAILURE;
+#endif
 	return rc;
 }
 #endif	/* MDB_ROBUST_SUPPORTED */

package/dependencies/lmdb/libraries/liblmdb/mdb_copy.1

@@ -1,74 +1,74 @@
-.TH MDB_COPY 1 "2017/07/31" "LMDB 0.9.90"
-.\" Copyright 2012-2021 Howard Chu, Symas Corp. All Rights Reserved.
-.\" Copying restrictions apply.  See COPYRIGHT/LICENSE.
-.SH NAME
-mdb_copy \- LMDB environment copy tool
-.SH SYNOPSIS
-.B mdb_copy
-[\c
-.BR \-V ]
-[\c
-.BR \-c ]
-[\c
-.BR \-n ]
-[\c
-.BR \-v ]
-[\c
-.BI \-m \ module
-[\c
-.BI \-w \ password\fR]]
-.B srcpath
-[\c
-.BR dstpath ]
-.SH DESCRIPTION
-The
-.B 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
-.I dstpath
-is specified it must be the path of an empty directory
-for storing the backup. Otherwise, the backup will be
-written to stdout.
-
-.SH OPTIONS
-.TP
-.BR \-V
-Write the library version number to the standard output, and exit.
-.TP
-.BR \-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.
-.TP
-.BR \-n
-Open LDMB environment(s) which do not use subdirectories.
-.TP
-.BR \-v
-Use the previous environment state instead of the latest state.
-This may be useful if the latest state has been corrupted.
-.TP
-.BI \-m \ module
-Load the specified dynamic module to utilize cryptographic functions.
-This is required to operate on environments that have been configured
-with page-level checksums or encryption.
-.TP
-.BI \-w \ password
-Specify the password for an encrypted environment. This is only
-used if a cryptography module has been loaded.
-
-.SH 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.
-.SH 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.
-.SH "SEE ALSO"
-.BR mdb_stat (1)
-.SH AUTHOR
-Howard Chu of Symas Corporation <http://www.symas.com>
+.TH MDB_COPY 1 "2017/07/31" "LMDB 0.9.90"
+.\" Copyright 2012-2021 Howard Chu, Symas Corp. All Rights Reserved.
+.\" Copying restrictions apply.  See COPYRIGHT/LICENSE.
+.SH NAME
+mdb_copy \- LMDB environment copy tool
+.SH SYNOPSIS
+.B mdb_copy
+[\c
+.BR \-V ]
+[\c
+.BR \-c ]
+[\c
+.BR \-n ]
+[\c
+.BR \-v ]
+[\c
+.BI \-m \ module
+[\c
+.BI \-w \ password\fR]]
+.B srcpath
+[\c
+.BR dstpath ]
+.SH DESCRIPTION
+The
+.B 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
+.I dstpath
+is specified it must be the path of an empty directory
+for storing the backup. Otherwise, the backup will be
+written to stdout.
+
+.SH OPTIONS
+.TP
+.BR \-V
+Write the library version number to the standard output, and exit.
+.TP
+.BR \-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.
+.TP
+.BR \-n
+Open LDMB environment(s) which do not use subdirectories.
+.TP
+.BR \-v
+Use the previous environment state instead of the latest state.
+This may be useful if the latest state has been corrupted.
+.TP
+.BI \-m \ module
+Load the specified dynamic module to utilize cryptographic functions.
+This is required to operate on environments that have been configured
+with page-level checksums or encryption.
+.TP
+.BI \-w \ password
+Specify the password for an encrypted environment. This is only
+used if a cryptography module has been loaded.
+
+.SH 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.
+.SH 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.
+.SH "SEE ALSO"
+.BR mdb_stat (1)
+.SH AUTHOR
+Howard Chu of Symas Corporation <http://www.symas.com>