cache\_dump(8) System Manager's Manual cache\_dump(8)

# [NAME](#NAME)

**cache\_dump** - dump cache metadata from device or file to standard output.

# [SYNOPSIS](#SYNOPSIS)

```
cache_dump [options] {device|file}
```

# [DESCRIPTION](#DESCRIPTION)

**cache\_dump** dumps binary cache metadata created by the device-mapper cache target on a device or file to standard output for analysis or postprocessing in XML format. XML formatted metadata can be fed into cache\_restore in order to put it back onto a metadata device (to process by the device-mapper target), or file.

This tool cannot be run on live metadata.

# [OPTIONS](#OPTIONS)

[**-h, --help**](#h)

Print help and exit.

[**-V, --version**](#V)

Print version information and exit.

[**-r, --repair**](#r)

Repair the metadata whilst dumping it.

[**-o {xml file}**](#o)

Specify an output file for the xml, rather than printing to stdout.

# [EXAMPLES](#EXAMPLES)

Dumps the cache metadata on logical volume /dev/vg/metadata to standard output in XML format:

```


    $ cache_dump /dev/vg/metadata
```

Dumps the cache metadata on logical volume /dev/vg/metadata whilst repairing it to standard output in XML format:

```


    $ cache_dump --repair /dev/vg/metadata
```

# [DIAGNOSTICS](#DIAGNOSTICS)

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

# [SEE ALSO](#SEE_ALSO)

[**cache\_check**(8)](/man/enterprise-packages/thin-provisioning-tools/cache_check.8), [**cache\_repair**(8)](/man/enterprise-packages/thin-provisioning-tools/cache_repair.8), [**cache\_restore**(8)](/man/enterprise-packages/thin-provisioning-tools/cache_restore.8)

# [AUTHOR](#AUTHOR)

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

Device Mapper Tools System Manager's Manual

---

Document: cache_dump(8) from thin-provisioning-tools 1.3.4-r4 (Chainguard OS)