]> git.proxmox.com Git - pve-docs.git/blame - vzdump.1-synopsis.adoc
update create VM screenshots
[pve-docs.git] / vzdump.1-synopsis.adoc
CommitLineData
1f554f76
DM
1*vzdump* `help`
2
3*vzdump* `{<vmid>}` `[OPTIONS]`
4
5Create backup.
6
013dc89f 7`<vmid>`: `<string>` ::
1f554f76 8
04ce4dfa 9The ID of the guest system you want to backup.
1f554f76 10
013dc89f 11`-all` `<boolean>` ('default =' `0`)::
1f554f76 12
04ce4dfa 13Backup all known guest systems on this host.
1f554f76 14
013dc89f 15`-bwlimit` `<integer> (0 - N)` ('default =' `0`)::
1f554f76
DM
16
17Limit I/O bandwidth (KBytes per second).
18
013dc89f 19`-compress` `<0 | 1 | gzip | lzo>` ('default =' `0`)::
1f554f76
DM
20
21Compress dump file.
22
013dc89f 23`-dumpdir` `<string>` ::
1f554f76
DM
24
25Store resulting files to specified directory.
26
013dc89f 27`-exclude` `<string>` ::
1f554f76 28
04ce4dfa 29Exclude specified guest systems (assumes --all)
1f554f76 30
013dc89f 31`-exclude-path` `<string>` ::
1f554f76 32
04ce4dfa 33Exclude certain files/directories (shell globs).
1f554f76 34
013dc89f 35`-ionice` `<integer> (0 - 8)` ('default =' `7`)::
1f554f76
DM
36
37Set CFQ ionice priority.
38
013dc89f 39`-lockwait` `<integer> (0 - N)` ('default =' `180`)::
1f554f76
DM
40
41Maximal time to wait for the global lock (minutes).
42
013dc89f 43`-mailnotification` `<always | failure>` ('default =' `always`)::
1f554f76
DM
44
45Specify when to send an email
46
013dc89f 47`-mailto` `<string>` ::
1f554f76 48
c2993fe5 49Comma-separated list of email addresses that should receive email notifications.
1f554f76 50
013dc89f 51`-maxfiles` `<integer> (1 - N)` ('default =' `1`)::
1f554f76 52
04ce4dfa 53Maximal number of backup files per guest system.
1f554f76 54
013dc89f 55`-mode` `<snapshot | stop | suspend>` ('default =' `snapshot`)::
1f554f76
DM
56
57Backup mode.
58
013dc89f 59`-node` `<string>` ::
1f554f76
DM
60
61Only run if executed on this node.
62
013dc89f 63`-pigz` `<integer>` ('default =' `0`)::
1f554f76 64
c2993fe5 65Use pigz instead of gzip when N>0. N=1 uses half of cores, N>1 uses N as thread count.
1f554f76 66
013dc89f 67`-quiet` `<boolean>` ('default =' `0`)::
1f554f76
DM
68
69Be quiet.
70
013dc89f 71`-remove` `<boolean>` ('default =' `1`)::
1f554f76
DM
72
73Remove old backup files if there are more than 'maxfiles' backup files.
74
013dc89f 75`-script` `<string>` ::
1f554f76
DM
76
77Use specified hook script.
78
013dc89f 79`-size` `<integer> (500 - N)` ('default =' `1024`)::
1f554f76 80
04ce4dfa 81Unused, will be removed in a future release.
1f554f76 82
013dc89f 83`-stdexcludes` `<boolean>` ('default =' `1`)::
1f554f76 84
04ce4dfa 85Exclude temporary files and logs.
1f554f76 86
013dc89f 87`-stdout` `<boolean>` ::
1f554f76
DM
88
89Write tar to stdout, not to a file.
90
013dc89f 91`-stop` `<boolean>` ('default =' `0`)::
1f554f76
DM
92
93Stop runnig backup jobs on this host.
94
013dc89f 95`-stopwait` `<integer> (0 - N)` ('default =' `10`)::
1f554f76 96
04ce4dfa 97Maximal time to wait until a guest system is stopped (minutes).
1f554f76 98
013dc89f 99`-storage` `<string>` ::
1f554f76
DM
100
101Store resulting file to this storage.
102
013dc89f 103`-tmpdir` `<string>` ::
1f554f76
DM
104
105Store temporary files to specified directory.
106