MDB_COPY(1)

💖 MDB_COPY 💖

okay bestie so this is mdb_copy, and it's the LMDB environment copy tool — literally the little legend that clones your whole LMDB env for you 🫶 (also hi, it's the general commands manual, section 1, in case anyone asks 💅)

✨ SYNOPSIS ✨

mdb_copy [-V] [-c] [-n] srcpath [dstpath]

🌸 DESCRIPTION 🌸

The mdb_copy utility copies an LMDB environment. The cute part? 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. no cap, that's the whole vibe 😌

🎀 OPTIONS 🎀

• -V — Write the library version number to the standard output, and exit. just a lil flex, then she's gone 💨
• -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. 😭 so like, it's giving thorough but it's also giving expensive
• -n — Open LDMB environment(s) which do not use subdirectories. for the ones living that flat-directory lifestyle 🦋

🩺 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. so if you get a number that isn't zero, that's your sign to actually read stderr, bestie 🙈

⚠️ 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.

like... the disk said "I'm full" and it meant it 💀 run it alongside writes and watch the size balloon fr fr

👀 SEE ALSO 👀

• mdb_stat(1)

👑 AUTHOR 👑

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

this page was brought to you by LMDB 0.9.14 🌈 dated 2014/07/01 — yeah she's vintage, she's iconic, she ate, periodt 💅✨