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

# [NAME](#NAME)

**thin\_restore** - restore thin provisioning metadata file to device or file.

# [SYNOPSIS](#SYNOPSIS)

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

# [DESCRIPTION](#DESCRIPTION)

**thin\_restore** restores thin provisioning metadata created by the respective device-mapper target dumped into an XML formatted (see [**thin\_dump**(8)](/man/enterprise-packages/thin-provisioning-tools/thin_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)

Suppress output messages, return only exit code.

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

Input file containing XML metadata.

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

Output file or device for restored binary metadata.

```


    If a file is used for output, then it must be preallocated, and large


    enough to hold the metadata.
```

[**--transaction-id {natural}**](#transaction_id)

Override the transaction id given in the input xml.

[**--data-block-size {natural}**](#data_block_size)

Override the data block size given in the input xml.

[**--nr-data-blocks {natural}**](#nr_data_blocks)

Override the nr data blocks given in the input xml.

# [EXAMPLE](#EXAMPLE)

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

```


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

# [DIAGNOSTICS](#DIAGNOSTICS)

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

# [SEE ALSO](#SEE_ALSO)

[**thin\_dump**(8)](/man/enterprise-packages/thin-provisioning-tools/thin_dump.8), [**thin\_check**(8)](/man/enterprise-packages/thin-provisioning-tools/thin_check.8), [**thin\_repair**(8)](/man/enterprise-packages/thin-provisioning-tools/thin_repair.8), [**thin\_rmap**(8)](/man/enterprise-packages/thin-provisioning-tools/thin_rmap.8), [**thin\_metadata\_size**(8)](/man/enterprise-packages/thin-provisioning-tools/thin_metadata_size.8)

# [AUTHOR](#AUTHOR)

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

Device Mapper Tools System Manager's Manual

---

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