# thin_restore - restore thin provisioning metadata file to device or f... - man(8) - [phpMan]

[_thin_restore_(8)](https://www.chedong.com/phpMan.php/man/thinrestore/8/markdown)                        System Manager's Manual                       [_thin_restore_(8)](https://www.chedong.com/phpMan.php/man/thinrestore/8/markdown)

## NAME
       **thin_restore **- restore thin provisioning metadata file to device or file.

## SYNOPSIS
       **thin_restore **[_options_] **-i **{xml file} **-o **{device|file}

## DESCRIPTION
       **thin_restore **restores thin provisioning metadata created by the respective device-mapper tar‐
       get  dumped  into  an  XML  formatted  (see  [**thin_dump**(8)](https://www.chedong.com/phpMan.php/man/thindump/8/markdown)) file, which optionally can be pre‐
       processed 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
### -h, --help
              Print help and exit.

### -V, --version
              Print version information and exit.

### -q, --quiet
              Suppress output messages, return only exit code.

### -i, --input {xml file}
              Input file containing XML metadata.

### -o, --output {device|file}
              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}
              Override the transaction id given in the input xml.

### --data-block-size {natural}
              Override the data block size given in the input xml.

### --nr-data-blocks {natural}
              Override the nr data blocks given in the input xml.

## 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
       **thin_restore **returns an exit code of 0 for success or 1 for error.

## SEE ALSO
       [**thin_dump**(8)](https://www.chedong.com/phpMan.php/man/thindump/8/markdown), [**thin_check**(8)](https://www.chedong.com/phpMan.php/man/thincheck/8/markdown), [**thin_repair**(8)](https://www.chedong.com/phpMan.php/man/thinrepair/8/markdown), [**thin_rmap**(8)](https://www.chedong.com/phpMan.php/man/thinrmap/8/markdown), [**thin_metadata_size**(8)](https://www.chedong.com/phpMan.php/man/thinmetadatasize/8/markdown)

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

System Manager's Manual                  Device Mapper Tools                         [_thin_restore_(8)](https://www.chedong.com/phpMan.php/man/thinrestore/8/markdown)