PMDK-CONVERT(1)

📦 version 1.7, in centos-stream 9, ubuntu jammy

💖 PMDK-CONVERT 💖

aka pmdk-convert from the PMDK Programmer's Manual — the lil tool that ✨upgrades your pool files' layout version✨

🌸 NAME 🌸

pmdk-convert — bestie, it upgrades the layout version of your pool files 🦋

🎀 SYNOPSIS 🎀

$ pmdk-convert <file>

✨ DESCRIPTION ✨

okay so, pmdk-convert does a conversion of the pool you point it at, bumping it up to the newest layout supported by this tool. rn only libpmemobj(7) pools are supported, so if that's your pool, slay 💅

⚠️ not me being the bearer of bad news but — the conversion process is not fail-safe. a power interruption may damage the pool. the move is to have a backup of the pool before conversion. fr fr, back it up first 🫶

also!! this tool doesn't support remote replicas 😭 before a conversion, all remote replicas have to be removed from the pool using the pmempool transform command. no skipping that step bestie.

👑 Options:

  • -V, --version — shows version info and dips out. iconic.
  • -h, --help — shows help, plus the list of supported layouts and the PMDK versions that go with them 🍓
  • -f, --from=pmdk-version — convert from the PMDK version you specify. this one is exclusive with the -F option (they cannot both show up, it's giving main character energy only one at a time).
  • -F, --from-layout=version — convert from the layout version you specify. this one is exclusive with the -f option.
  • -t, --to=version — convert to the specified PMDK version. exclusive with the -T option.
  • -T, --to-layout=version — convert to the specified layout version. exclusive with the -t option.
  • -X, --force-yes=[question] — reply positively to the question you specify 💅 possible questions are: fail-safety, 1.2-pmemmutex

🌈 EXAMPLE 🌈

$ pmempool convert pool.obj

Updates pool.obj to the latest layout version. ⭐

$ pmempool convert pool.obj --from=1.2 --to=1.4

Updates pool.obj from PMDK 1.2 to PMDK 1.4 🦋

💜 SEE ALSO 💜

pmempool(1), libpmemblk(7), libpmemlog(7), libpmemobj(7), libpmempool(7) and <http://pmem.io> 🔥

and that's the whole page bestie, no cap 🧚 this was PMDK - pmem Tools version 1.5, dated 2019-01-30 — periodt 💖✨🎀

📦 where this page comes from