thin_repair(8)

✨ thin_repair(8) ✨

Okay so the manual name is thin_repair(8) 💖 and the NAME section is literally just the tool's whole vibe:

🎀 NAME 🎀

thin_repair — repair thin provisioning binary metadata. 🩹✨

💅 SYNOPSIS 💅

thin_repair [options] -i {device|file} -o {device|file}

🌸 DESCRIPTION 🌸

Okay bestie, so thin_repair reads binary thin provisioning metadata that was made by the respective device-mapper target 🧚. It reads from one device or file, repairs it, and then writes the fixed version out to a different device or file. If you write it to a metadata device, the device-mapper target can actually process it afterwards 🔥.

💀 Big warning: this tool cannot be run on live metadata. Do NOT try it on metadata that's currently in use. 🙈

👑 OPTIONS 👑

• -h, --help — Prints help and exits. Main character moment, bye 👋
• -V, --version — Prints version information and exits. 🦋
• -i, --input {device|file} — The input file or device holding the binary data 💜
• -o, --output {device|file} — The output file or device where the binary data goes 🍓

⚠️ If you're using a file for output, it has to be preallocated and big enough to hold the metadata. No cap, this matters 😭

• --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 this one is so iconic. It reads the binary thin provisioning metadata from the file metadata, repairs it, and writes it to the logical volume /dev/vg/metadata so the respective device-mapper target can process it afterwards 🧚💖:

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

🌈 DIAGNOSTICS 🌈

thin_repair returns an exit code of 0 for success or 1 for error. Success is giving 🥹✅, error is giving 💀.

🔥 SEE ALSO 🔥

thin_dump(8), thin_check(8), thin_restore(8), thin_rmap(8), thin_metadata_size(8) 💜

🫶 AUTHOR 🫶

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

Bye bestie, that's the whole page 🎀 Source: System Manager's Manual, Device Mapper Tools, thin_repair(8) 💖 ✨