cache_check(8)

✨ cache_check(8) ✨

okay so bestie, this is the manual page for cache_check(8) 💅 it's from the System Manager's Manual and I'm obsessed with it 🫶

🎀 NAME 🎀

cache_check - validates cache metadata on a device or file. 💖

🧚 SYNOPSIS 🧚

cache_check [options] {device|file}

📖 DESCRIPTION 📖

okay so cache_check is the one that goes through the cache metadata made by the device-mapper cache target on a device or file ✨ it's giving checkup energy 🩺

💀 bestie, this tool cannot be run on live metadata!! it's a hard no 🙅‍♀️

🌸 OPTIONS 🌸

• -h, --help — prints help and exits 🍓
• -V, --version — outputs version information and exits 🦋
• -q, --quiet — suppresses output messages so you only get the exit code 🤫
• --super-block-only — only checks the superblock 👑
• --skip-hints — skips checking the policy hint values metadata 🙈
• --skip-discards — skips checking the discard bits in the metadata 🧹
• --clear-needs-check-flag — clears the needs_check flag in the superblock 💜

ok so the kernel may set a flag that forces the pool to get checked before it's next activated 🔥 use this switch to clear that flag, but only if the check passes! if the metadata check fails, the flag stays put and you'll need a cache_repair run to fix stuff 🛠️ once cache_repair succeeds, you can run cache_check again and slay ✨

💅 EXAMPLE 💅

analyses and repairs cache metadata on logical volume /dev/vg/metadata: 🌈

$ cache_check /dev/vg/metadata

🙈 the device may not be actively used by the target when running, so keep that in mind!

🚨 DIAGNOSTICS 🚨

cache_check returns an exit code of 0 for success or 1 for error 🎯 0 is the W, 1 is the L 😭

🔗 SEE ALSO 🔗

cache_dump(8), cache_repair(8), cache_restore(8) 🫶

👑 AUTHOR 👑

Joe Thornber <ejt@redhat.com>, Heinz Mauelshagen <HeinzM@RedHat.com> 💖

okay that's the whole tea, bestie 🍵✨ this page came from the System Manager's Manual, Device Mapper Tools, and it's the cache_check(8) crew all the way 🦋 stay iconic, and check your metadata before it checks you 💅🌈