zvault-restore(1) -- Restore a backup or subtree
================================================

## SYNOPSIS

`zvault restore [OPTIONS] <BACKUP> <DST>`


## DESCRIPTION

This subcommand restores a backup or a backup subtree `BACKUP` into the folder
`DST`.

The backup or backup subtree given by `BACKUP` must be in the format
`[repository]::backup_name[::subtree]` as described in _zvault(1)_.
If `repository` is omitted, the default repository location is used instead.

If `--tar` is set, the data is written to a tar file named `DST`. In this case
`DST` must not exist. If `DST` is `-`, the data will be written to stdout.

If `--tar` is not set, the data will be written into the existing folder `DST`.


## OPTIONS

* `--tar`:

  Write the backup to a tar archive named `DST` instead of creating files and
  folders at this location.

  This option can be used to export a backup that can be imported again using
  zvault-backup(1) with the `--tar` flag.


* `-q`, `--quiet`:

  Print less information


* `-v`, `--verbose`:

  Print more information


* `-h`, `--help`:

  Prints help information


* `-V`, `--version`:     

  Prints version information


## COPYRIGHT

Copyright (C) 2017  Dennis Schwerdel
This software is licensed under GPL-3 or newer (see LICENSE.md)