---
name: "cache_repair"
section: "8"
platform: "linux"
package: "thin-provisioning-tools"
version: "1.3.4-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/cache_repair"
---

# cache\_repair(8)

repair cache binary metadata from device/file to device/file.

## NAME

**cache\_repair** - repair cache binary metadata from device/file to device/file.

## SYNOPSIS

```
cache_repair [options] -i {device|file} -o {device|file}
```

## DESCRIPTION

**cache\_repair reads binary cache metadata created by the respective** **device-mapper target from one device or file, repairs it and writes it to** **another device or file. If written to a metadata device, the metadata can** **be processed by the device-mapper target.**

**This tool cannot be run on live metadata.**

## OPTIONS

- **-h, --help**

  **Print help and exit.**

- **-V, --version**

  **Print version information and exit.**

- **-i, --input {device\|file}**

  **Input file or device containing binary metadata.**

- **-o, --output {device\|file}**

  **Output file or device for repaired binary metadata.**

```
    If a file is then it must be preallocated, and large enough to hold the
    metadata.
```

## EXAMPLE

**Reads the binary cache metadata from file metadata, repairs it and writes it** **to logical volume /dev/vg/metadata for further processing by the respective** **device-mapper target:**

```
    $ cache_repair -i metadata -o /dev/vg/metadata
```

## DIAGNOSTICS

**cache\_repair returns an exit code of 0 for success or 1 for error.**

## SEE ALSO

**[cache\_dump(8)](/cache_dump/8.md), [cache\_check(8)](/cache_check/8.md), [cache\_restore(8)](/cache_restore/8.md)**

## AUTHOR

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