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

# [NAME](#NAME)

**cache\_restore** - restore cache metadata file to device or file.

# [SYNOPSIS](#SYNOPSIS)

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

# [DESCRIPTION](#DESCRIPTION)

**cache\_restore** restores cache metadata created by the respective device-mapper target dumped into an XML formatted (see [**cache\_dump**(8)](/man/enterprise-packages/thin-provisioning-tools/cache_dump.8)) file, which optionally can be preprocessed before the restore to another device or file. If restored to a metadata device, the metadata can be processed by the device-mapper target.

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.

[**-q, --quiet**](#q)

Don't print any output. Check the exit code to test for success.

[**-i, --input {xml file}**](#i)

Input xml.

[**-o, --output {device|file}**](#o)

Output file or device for restored binary metadata.

```


    If a file is used thin it must be preallocated, and large enough to hold


    the metadata.
```

[**--metadata-version {1|2}**](#metadata_version)

Choose a metadata version.

# [DEBUGGING OPTIONS](#DEBUGGING_OPTIONS)

[**--debug-override-metadata-version {integer}**](#debug_override_metadata_version)

Override the version stored in the metadata.

[**--omit-clean-shutdown**](#omit_clean_shutdown)

Don't set the clean shutdown flag.

# [EXAMPLE](#EXAMPLE)

Restores the XML formatted cache metadata on file metadata to logical volume /dev/vg/metadata for further processing by the respective device-mapper target:

```


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

# [DIAGNOSTICS](#DIAGNOSTICS)

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

# [SEE ALSO](#SEE_ALSO)

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

# [AUTHOR](#AUTHOR)

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

Device Mapper Tools System Manager's Manual

---

Document: cache_restore(8) from thin-provisioning-tools 1.3.4-r3 (Chainguard OS)