man > cache_restore(8)

man perldoc info pydoc3 ri search

✅ NAME

cache_restore – restore cache metadata file to device or file.

🚀 Quick Reference

Use Case	Command	Description
🔄 Restore metadata from XML to device	cache_restore -i metadata.xml -o /dev/vg/metadata	Restore cache metadata from XML file to a logical volume for use by device-mapper target
📋 Specify metadata version	cache_restore -i metadata.xml -o /dev/vg/metadata --metadata-version 2	Restore with a specific metadata version (1 or 2)
🔇 Quiet mode (no output)	cache_restore -q -i metadata.xml -o /dev/vg/metadata	Suppress all output; check exit code for success
❓ Display help	cache_restore -h	Print help and exit
ℹ️ Version info	cache_restore -V	Print version information and exit

📋 SYNOPSIS

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

📝 DESCRIPTION

cache_restore restores cache metadata created by the respective device-mapper target dumped into an XML formatted (see cache_dump(8)) file, which optionally can be preprocessed before the restore to another device or file. If restored to a metadata device, the metadata can be processed by the device-mapper target.

This tool cannot be run on live metadata.

⚙️ OPTIONS

📖 Help & Version

-h, --help – Print help and exit.

-V, --version – Print version information and exit.

-q, --quiet – Don't print any output. Check the exit code to test for success.

📂 Input/Output

-i, --input {xml file} – Input xml.

-o, --output {device|file} – Output file or device for restored binary metadata. If a file is used, it must be preallocated and large enough to hold the metadata.

🔧 Metadata Version

--metadata-version {1|2} – Choose a metadata version.

🐞 DEBUGGING OPTIONS

🔬 Override & Flags

--debug-override-metadata-version {integer} – Override the version stored in the metadata.

--omit-clean-shutdown – Don't set the clean shutdown flag.

💡 EXAMPLE

Restores the XML formatted cache metadata on file metadata to logical volume /dev/vg/metadata for further processing by the respective device-mapper target:

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

🩺 DIAGNOSTICS

cache_restore returns an exit code of 0 for success or 1 for error.

📚 SEE ALSO

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

✍️ AUTHOR

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

✅ NAME 🚀 Quick Reference 📋 SYNOPSIS 📝 DESCRIPTION ⚙️ OPTIONS 🐞 DEBUGGING OPTIONS 💡 EXAMPLE 🩺 DIAGNOSTICS 📚 SEE ALSO ✍️ AUTHOR