db1d4b5d48
Allow setting alternative qrexec service to retrieve backup content. The service API is slightly different than the default one: it will get only list of files/directories to extract on its stdin, but not backup location. The latter could be provided as a service argument, or using other out-of-band mechanism. This will be useful for paranoid backup restore mode, to take away control over location/command from sandboxed qvm-backup-restore process. QubesOS/qubes-issues#5310
101 lines
2.6 KiB
ReStructuredText
101 lines
2.6 KiB
ReStructuredText
.. program:: qvm-backup-restore
|
|
|
|
===============================================================
|
|
:program:`qvm-backup-restore` -- Restores Qubes VMs from backup
|
|
===============================================================
|
|
|
|
.. warning::
|
|
|
|
This page was autogenerated from command-line parser. It shouldn't be 1:1
|
|
conversion, because it would add little value. Please revise it and add
|
|
more descriptive help, which normally won't fit in standard ``--help``
|
|
option.
|
|
|
|
After rewrite, please remove this admonition.
|
|
|
|
Synopsis
|
|
========
|
|
:command:`qvm-backup-restore` [*options*] <*backup-dir*>
|
|
|
|
Options
|
|
=======
|
|
|
|
.. option:: --help, -h
|
|
|
|
Show this help message and exit
|
|
|
|
.. option:: --verbose, -v
|
|
|
|
Increase verbosity
|
|
|
|
.. option:: --quiet, -q
|
|
|
|
Decrease verbosity
|
|
|
|
|
|
.. option:: --verify-only
|
|
|
|
Do not restore the data, only verify backup integrity
|
|
|
|
.. option:: --skip-broken
|
|
|
|
Do not restore VMs that have missing templates or netvms
|
|
|
|
.. option:: --ignore-missing
|
|
|
|
Ignore missing templates or netvms, restore VMs anyway
|
|
|
|
.. option:: --skip-conflicting
|
|
|
|
Do not restore VMs that are already present on the host
|
|
|
|
.. option:: --rename-conflicting
|
|
|
|
Restore VMs that are already present on the host under different names
|
|
|
|
.. option:: --exclude=EXCLUDE, -x EXCLUDE
|
|
|
|
Skip restore of specified VM (might be repeated)
|
|
|
|
.. option:: --skip-dom0-home
|
|
|
|
Do not restore dom0 user home dir
|
|
|
|
.. option:: --ignore-username-mismatch
|
|
|
|
Ignore dom0 username mismatch while restoring homedir
|
|
|
|
.. option:: --ignore-size-limit
|
|
|
|
Backup metadata contains expected size of each VM. By default if backup
|
|
contains more data than expected, it is rejected. Use this option to ignore
|
|
this limit and restore such (broken, or potentially malicious) backup
|
|
anyway.
|
|
|
|
.. option:: --compression-filter, -Z
|
|
|
|
Force specific compression filter, instead of the one named in the backup
|
|
header. The compression filter is a command that accepts ``-d`` option to
|
|
decompress data on stdin and output it to stdout. This can be used to
|
|
override built-in protection against uncommon compression.
|
|
|
|
.. option:: --dest-vm=APPVM, -d APPVM
|
|
|
|
Restore from a backup located in a specific AppVM
|
|
|
|
.. option:: --passphrase-file, -p
|
|
|
|
Read passphrase from file, or use '-' to read from stdin
|
|
|
|
.. option:: --location-is-service
|
|
|
|
Provided backup location is a qrexec service name (optionally with an
|
|
argument, separated by ``+``), instead of file path or a command.
|
|
|
|
|
|
Authors
|
|
=======
|
|
| Joanna Rutkowska <joanna at invisiblethingslab dot com>
|
|
| Rafal Wojtczuk <rafal at invisiblethingslab dot com>
|
|
| Marek Marczykowski <marmarek at invisiblethingslab dot com>
|