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