PMEMPOOL-CHECK(1)

📦
version 1.13.1 · 6 versions
, in debian trixie, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💅 pmempool-check — check and repair persistent memory pool ✨

okay so this is straight out of the PMDK Programmer's Manual, and it's literally the vibe check for your persistent memory pool files 🫶

🌸 NAME 🌸

pmempool-check — check and repair persistent memory pool. yes bestie, it does exactly what it says on the tin 💖

✨ SYNOPSIS ✨

$ pmempool check [<options>] <file>

🚨 NOTE 🚨

NOTICE: The libpmemblk and libpmemlog libraries are deprecated since PMDK 1.13.0 release. 😭 so if you're still using them... iykyk, but like, maybe don't start anything new with them fr fr.

💜 DESCRIPTION 💜

So when pmempool gets called with the check command, it checks the consistency of a given pool file. that's the whole bit 🎀

If the pool file is consistent, pmempool exits with 0 value. slay. ✨ If the pool file is not consistent, a non-zero error code is returned. 💀

In case of any errors, the proper message is printed. ngl that's pretty helpful of it. The verbosity level may be increased using the -v option, and the output messages may also be suppressed using the -q option. pick your fighter 🦋

It is possible to try to fix encountered problems using the -r option. and because we're responsible main characters, in order to be sure this will not corrupt your data you can either create a backup of the pool file using the -b option, or just print what would be fixed without modifying the original pool using the -N option. protect your data, periodt 👑

NOTE: Currently, checking the consistency of a pmemobj pool is not supported. 🙈 yeah. that one's not invited to the party yet.

🎀 Available options: 🎀

  • -r, --repair — Try to repair a pool file if possible. the "let me fix her" option 💅
  • -y, --yes — Answer yes on all questions. no more popping up to ask, you already said yes 💖
  • -d, --dry-run — Don't execute, just show what would be done. Not supported on Device DAX. lowkey the safest way to peek 👀
  • -N, --no-exec — Deprecated alias for dry-run. it's giving legacy era, still works tho 🫶
  • -b, --backup <file> — Create backup of a pool file before executing. Terminate if it is not possible to create a backup file. This option requires the -r option. no backup, no entry, rules are rules ✨
  • -a, --advanced — Perform advanced repairs. This option enables more aggressive steps in attempts to repair a pool. This option requires -r, --repair. ok go off, more aggressive steps 🔥
  • -q, --quiet — Be quiet and don't print any messages. 🤫 silent mode activated
  • -v, --verbose — Be more verbose. tell me EVERYTHING bestie 🗣️
  • -h, --help — Display help message and exit. our classic exit strategy 🚪

🌈 EXAMPLE 🌈

$ pmempool check pool.bin

Check consistency of "pool.bin" pool file — that's it, that's the whole cute lil command 🦋

$ pmempool check --repair --backup pool.bin.backup pool.bin

Check consistency of "pool.bin" pool file, create backup and repair if necessary. icon behaviour honestly 👑

$ pmempool check -rvN pool.bin

Check consistency of "pool.bin" pool file, print what would be repaired with increased verbosity level. the way this combo ate 💅✨

🌟 SEE ALSO 🌟

pmempool(1), libpmemblk(7), libpmemlog(7), libpmemobj(7), libpmempool(7) and <https://pmem.io> — go read the family, they're all iconic in their own way 🫶

💖 that's the whole page! brought to you by the PMDK Programmer's Manual, PMDK, dated 2023-05-31 — stay consistent out there bestie, mwah 💖

📦 where this page comes from