OS Manuals

/usr/bin/cache_restore

Tools for checking, repairing and dumping dm-thin, dm-cache and dm-era metadata

From thin-provisioning-tools 1.3.4-r5 (enterprise-packages), captured 2026-11-08 by running cache_restore --help (exit 0). permalink

Convert XML format metadata to binary.

Usage: cache_restore [OPTIONS] --input <FILE> --output <FILE>

Options:
  -h, --help                    Print help
  -i, --input <FILE>            Specify the input xml
      --metadata-version <NUM>  Specify the output metadata version [default: 2] [possible values: 1, 2]
  -o, --output <FILE>           Specify the output device
      --omit-clean-shutdown     Don't set the clean shutdown flag
  -q, --quiet                   Suppress output messages, return only exit code
  -V, --version                 Print version
Options (8)
OptionDescriptionSource
-h, --helpPrint help and exit.help + man
-i, --input FILESpecify the input xmlhelp + man
--metadata-version NUMSpecify the output metadata version [default: 2] [possible values: 1, 2]help + man
-o, --output FILEOutput file or device for restored binary metadata.help + man
--omit-clean-shutdownDon't set the clean shutdown flag.help + man
-q, --quietSuppress output messages, return only exit codehelp + man
-V, --versionPrint version information and exit.help + man
--debug-override-metadata-version integerOverride the version stored in the metadata. (in the manual page but not in --help)man
Examples (1) from the manual page, untested

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.