thin_restore(8)

✨ thin_restore(8) ✨ — NAME 💖

okay so the manual name here is thin_restore 🎀 and it's a tool to restore thin provisioning metadata file to device or file. literally that's the whole vibe 💅

🧚 SYNOPSIS 🧚

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

🌸 DESCRIPTION 🌸

okay so thin_restore takes thin provisioning metadata that was created by the respective device-mapper target and dumped into an XML formatted (see thin_dump(8)) file 📄✨ it can optionally preprocess that stuff before restoring it to another device or file. and if you restore it to a metadata device, the metadata can then be processed by the device-mapper target 🦋

bestie, this tool cannot be run on live metadata 🙈 don't even try it, it's a no-go 💀

👑 OPTIONS 👑

• -h, --help — prints help and exits 🫶
• -V, --version — prints version information and exits 🔥
• -q, --quiet — suppresses output messages so you only get the exit code 🤫
• -i, --input {xml file} — the input file containing the XML metadata 📄
• -o, --output {device|file} — the output file or device where the restored binary metadata goes 💜

if you're using a file for output, it must be preallocated and big enough to hold the metadata 🍓 no shortcuts, bestie

• --transaction-id {natural} — overrides the transaction id given in the input xml ✨
• --data-block-size {natural} — overrides the data block size given in the input xml 🌈
• --nr-data-blocks {natural} — overrides the nr data blocks given in the input xml 💅

🎀 EXAMPLE 🎀

okay so this one restores the XML formatted thin provisioning metadata in the file metadata to the logical volume /dev/vg/metadata so it's ready for the respective device-mapper target to process 😭

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

🦋 DIAGNOSTICS 🦋

thin_restore returns an exit code of 0 for success or 1 for error 💖

🌈 SEE ALSO 🌈

thin_dump(8), thin_check(8), thin_repair(8), thin_rmap(8), thin_metadata_size(8) ⭐

💜 AUTHOR 💜

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

bye bestie, that's thin_restore from Device Mapper Tools, System Manager's Manual 🌈✨💅