]> git.proxmox.com Git - pve-docs.git/blame - vzdump.conf.5-opts.adoc
network: adapt apply config section to PVE 7
[pve-docs.git] / vzdump.conf.5-opts.adoc
CommitLineData
013dc89f 1`bwlimit`: `<integer> (0 - N)` ('default =' `0`)::
d083d3d3
DM
2
3Limit I/O bandwidth (KBytes per second).
4
c5aa7e14 5`compress`: `<0 | 1 | gzip | lzo | zstd>` ('default =' `0`)::
d083d3d3
DM
6
7Compress dump file.
8
013dc89f 9`dumpdir`: `<string>` ::
d083d3d3
DM
10
11Store resulting files to specified directory.
12
013dc89f 13`exclude-path`: `<string>` ::
d083d3d3 14
d2656385 15Exclude certain files/directories (shell globs). Paths starting with '/' are anchored to the container's root, other paths match relative to each subdirectory.
d083d3d3 16
013dc89f 17`ionice`: `<integer> (0 - 8)` ('default =' `7`)::
d083d3d3
DM
18
19Set CFQ ionice priority.
20
013dc89f 21`lockwait`: `<integer> (0 - N)` ('default =' `180`)::
d083d3d3
DM
22
23Maximal time to wait for the global lock (minutes).
24
013dc89f 25`mailnotification`: `<always | failure>` ('default =' `always`)::
d083d3d3
DM
26
27Specify when to send an email
28
013dc89f 29`mailto`: `<string>` ::
d083d3d3 30
d2656385 31Comma-separated list of email addresses or users that should receive email notifications.
d083d3d3 32
0695fdaf 33`maxfiles`: `<integer> (1 - N)` ::
d083d3d3 34
0695fdaf 35Deprecated: use 'prune-backups' instead. Maximal number of backup files per guest system.
d083d3d3 36
013dc89f 37`mode`: `<snapshot | stop | suspend>` ('default =' `snapshot`)::
d083d3d3
DM
38
39Backup mode.
40
7af2edf9
TL
41`notes-template`: `<string>` ::
42
43Template string for generating notes for the backup(s). It can contain variables which will be replaced by their values. Currently supported are \{\{cluster\}\}, \{\{guestname\}\}, \{\{node\}\}, and \{\{vmid\}\}, but more might be added in the future.
44+
45NOTE: Requires option(s): `storage`
46
013dc89f 47`pigz`: `<integer>` ('default =' `0`)::
d083d3d3 48
c2993fe5 49Use pigz instead of gzip when N>0. N=1 uses half of cores, N>1 uses N as thread count.
d083d3d3 50
9226ccbc
TL
51`pool`: `<string>` ::
52
53Backup all known guest systems included in the specified pool.
54
7af2edf9
TL
55`protected`: `<boolean>` ::
56
57If true, mark backup(s) as protected.
58+
59NOTE: Requires option(s): `storage`
60
0695fdaf 61`prune-backups`: `[keep-all=<1|0>] [,keep-daily=<N>] [,keep-hourly=<N>] [,keep-last=<N>] [,keep-monthly=<N>] [,keep-weekly=<N>] [,keep-yearly=<N>]` ('default =' `keep-all=1`)::
739d4d64
TL
62
63Use these retention options instead of those from the storage configuration.
64
4772952b
TL
65`keep-all`=`<boolean>` ;;
66
67Keep all backups. Conflicts with the other options when true.
68
739d4d64
TL
69`keep-daily`=`<N>` ;;
70
71Keep backups for the last <N> different days. If there is morethan one backup for a single day, only the latest one is kept.
72
73`keep-hourly`=`<N>` ;;
74
75Keep backups for the last <N> different hours. If there is morethan one backup for a single hour, only the latest one is kept.
76
77`keep-last`=`<N>` ;;
78
79Keep the last <N> backups.
80
81`keep-monthly`=`<N>` ;;
82
83Keep backups for the last <N> different months. If there is morethan one backup for a single month, only the latest one is kept.
84
85`keep-weekly`=`<N>` ;;
86
87Keep backups for the last <N> different weeks. If there is morethan one backup for a single week, only the latest one is kept.
88
89`keep-yearly`=`<N>` ;;
90
91Keep backups for the last <N> different years. If there is morethan one backup for a single year, only the latest one is kept.
92
013dc89f 93`remove`: `<boolean>` ('default =' `1`)::
d083d3d3 94
0695fdaf 95Prune older backups according to 'prune-backups'.
d083d3d3 96
013dc89f 97`script`: `<string>` ::
d083d3d3
DM
98
99Use specified hook script.
100
013dc89f 101`stdexcludes`: `<boolean>` ('default =' `1`)::
d083d3d3
DM
102
103Exclude temporary files and logs.
104
013dc89f 105`stopwait`: `<integer> (0 - N)` ('default =' `10`)::
d083d3d3
DM
106
107Maximal time to wait until a guest system is stopped (minutes).
108
013dc89f 109`storage`: `<string>` ::
d083d3d3
DM
110
111Store resulting file to this storage.
112
013dc89f 113`tmpdir`: `<string>` ::
d083d3d3
DM
114
115Store temporary files to specified directory.
116
c5aa7e14
TL
117`zstd`: `<integer>` ('default =' `1`)::
118
119Zstd threads. N=0 uses half of the available cores, N>0 uses N as thread count.
120