OS Manuals

/usr/bin/cache_writeback

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_writeback --help (exit 0). permalink

Repair binary cache metadata, and write it to a different device or file

Usage: cache_writeback [OPTIONS] --metadata-device <FILE> --origin-device <FILE> --fast-device <FILE>

Options:
      --buffer-size-meg <MB>            Specify the size for the data cache, in megabytes
      --fast-device <FILE>              Specify the fast device containing the data that needs to be written back
      --fast-device-offset <SECTORS>    Specify the data offset within the fast device
  -h, --help                            Print help
      --list-failed-blocks              List any blocks that failed the writeback process
      --metadata-device <FILE>          Specify the cache metadata device
      --no-metadata-update              Do not clear the dirty flags in metadata
      --origin-device <FILE>            Specify the slow device begin cached
      --origin-device-offset <SECTORS>  Specify the data offset within the slow device
  -q, --quiet                           Suppress output messages, return only exit code.
      --retry-count <CNT>               Specify how many times to retry data copying on failed data block [default: 0]
  -V, --version                         Print version
Options (12)
OptionDescriptionSource
--buffer-size-meg MBSpecify the size for the data cache, in megabytes.help + man
--fast-device FILESpecify the fast device containing the data that needs to be written backhelp + man
--fast-device-offset SECTORSSpecify the data offset within the fast devicehelp
-h, --helpPrint help and exit.help + man
--list-failed-blocksList any blocks that failed the writeback process.help + man
--metadata-device FILESpecify the cache metadata devicehelp + man
--no-metadata-updateDo not update the metadata to clear the dirty flags.help + man
--origin-device FILESpecify the slow device begin cachedhelp + man
--origin-device-offset SECTORSSpecify the data offset within the slow devicehelp
-q, --quietSuppress output messages, return only exit code.help
--retry-count CNTSpecify how many times to retry data copying on failed data block [default: 0]help
-V, --versionPrint version information and exit.help + man

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