cache_restore(8)

✨ cache_restore(8) ✨

okay bestie, this is the manual page for cache_restore, the tool that is literally the glow-up for your cache metadata 💖

🎀 NAME 🎀

cache_restore - restore cache metadata file to device or file. 🦋

🔮 SYNOPSIS 🔮

cache_restore [options] -i {xml file} -o {device|file}

💅 DESCRIPTION 💅

okay so cache_restore takes cache metadata that was dumped into an XML formatted file (see cache_dump(8)) and rebuilds it as binary metadata. the XML was made by the respective device-mapper target, and you can optionally tidy it up before the restore, then send it to another device or file 🌸 if you restore onto a metadata device, the device-mapper target can then process that metadata. iconic behavior ngl ✨

💀 Big warning: this tool cannot be run on live metadata. don't even try it, bestie 🙈

🌈 OPTIONS 🌈

• -h, --help — slides in with the help text and then exits 💖
• -V, --version — shows you the version info and then exits 🦋
• -q, --quiet — no output at all, zero chatter 🤫 you check the exit code to see if it worked
• -i, --input {xml file} — the input XML, the thing we're restoring from 📄
• -o, --output {device|file} — the output file or device where the restored binary metadata lands 🎯

⚠️ Heads up: if you're using a file, it has to be preallocated (it's giving thin provisioning vibes) and it needs to be big enough to hold the metadata. no cap, this matters 💅

• --metadata-version {1|2} — pick which metadata version you want 🧚

🛠️ DEBUGGING OPTIONS 🛠️

these are for the nerdy stuff, so use with care 🤓

• --debug-override-metadata-version {integer} — overrides the version that's stored in the metadata 🔧
• --omit-clean-shutdown — doesn't set the clean shutdown flag. lowkey sus, so only do it if you know why 🙃

📖 EXAMPLE 📖

okay so this one restores the XML formatted cache metadata in the file metadata onto the logical volume /dev/vg/metadata, so the respective device-mapper target can process it next ✨

$ cache_restore -i metadata -o /dev/vg/metadata

🩺 DIAGNOSTICS 🩺

cache_restore returns an exit code of 0 for success or 1 for error. so check that number if you're using --quiet 💜

🔗 SEE ALSO 🔗

cache_dump(8), cache_check(8), cache_repair(8) 🫶

👑 AUTHOR 👑

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

---

that's the whole tea, bestie! 🌈 this page came from the Device Mapper Tools kit, and it's the cache_restore(8) page from the System Manager's Manual 💅✨ periodt 🦋