X-Git-Url: https://git.proxmox.com/?p=pve-docs.git;a=blobdiff_plain;f=vzdump.conf.5-opts.adoc;h=21b96e87885f824135f5ec6cca04011fe9249dfa;hp=2e72b238d848781d7a6bceb09eaaefd5ae0a2858;hb=43530f6fe44c20926717a95e02aa19400ad2409c;hpb=d083d3d384304e74892ad5d6907c8eb9f1444fb8 diff --git a/vzdump.conf.5-opts.adoc b/vzdump.conf.5-opts.adoc index 2e72b23..21b96e8 100644 --- a/vzdump.conf.5-opts.adoc +++ b/vzdump.conf.5-opts.adoc @@ -1,69 +1,108 @@ -`bwlimit`: `integer (0 - N)` (default=`0`):: +`bwlimit`: ` (0 - N)` ('default =' `0`):: Limit I/O bandwidth (KBytes per second). -`compress`: `(0 | 1 | gzip | lzo)` (default=`0`):: +`compress`: `<0 | 1 | gzip | lzo | zstd>` ('default =' `0`):: Compress dump file. -`dumpdir`: `string` :: +`dumpdir`: `` :: Store resulting files to specified directory. -`exclude-path`: `string` :: +`exclude-path`: `` :: Exclude certain files/directories (shell globs). -`ionice`: `integer (0 - 8)` (default=`7`):: +`ionice`: ` (0 - 8)` ('default =' `7`):: Set CFQ ionice priority. -`lockwait`: `integer (0 - N)` (default=`180`):: +`lockwait`: ` (0 - N)` ('default =' `180`):: Maximal time to wait for the global lock (minutes). -`mailnotification`: `(always | failure)` (default=`always`):: +`mailnotification`: `` ('default =' `always`):: Specify when to send an email -`mailto`: `string` :: +`mailto`: `` :: -no description available +Comma-separated list of email addresses that should receive email notifications. -`maxfiles`: `integer (1 - N)` (default=`1`):: +`maxfiles`: ` (1 - N)` ('default =' `1`):: Maximal number of backup files per guest system. -`mode`: `(snapshot | stop | suspend)` (default=`snapshot`):: +`mode`: `` ('default =' `snapshot`):: Backup mode. -`pigz`: `integer` (default=`0`):: +`pigz`: `` ('default =' `0`):: -Use pigz instead of gzip when N>0. N=1 uses half of cores, N>1 uses N as -thread count. +Use pigz instead of gzip when N>0. N=1 uses half of cores, N>1 uses N as thread count. -`remove`: `boolean` (default=`1`):: +`pool`: `` :: + +Backup all known guest systems included in the specified pool. + +`prune-backups`: `[keep-all=<1|0>] [,keep-daily=] [,keep-hourly=] [,keep-last=] [,keep-monthly=] [,keep-weekly=] [,keep-yearly=]` :: + +Use these retention options instead of those from the storage configuration. + +`keep-all`=`` ;; + +Keep all backups. Conflicts with the other options when true. + +`keep-daily`=`` ;; + +Keep backups for the last different days. If there is morethan one backup for a single day, only the latest one is kept. + +`keep-hourly`=`` ;; + +Keep backups for the last different hours. If there is morethan one backup for a single hour, only the latest one is kept. + +`keep-last`=`` ;; + +Keep the last backups. + +`keep-monthly`=`` ;; + +Keep backups for the last different months. If there is morethan one backup for a single month, only the latest one is kept. + +`keep-weekly`=`` ;; + +Keep backups for the last different weeks. If there is morethan one backup for a single week, only the latest one is kept. + +`keep-yearly`=`` ;; + +Keep backups for the last different years. If there is morethan one backup for a single year, only the latest one is kept. + +`remove`: `` ('default =' `1`):: Remove old backup files if there are more than 'maxfiles' backup files. -`script`: `string` :: +`script`: `` :: Use specified hook script. -`stdexcludes`: `boolean` (default=`1`):: +`stdexcludes`: `` ('default =' `1`):: Exclude temporary files and logs. -`stopwait`: `integer (0 - N)` (default=`10`):: +`stopwait`: ` (0 - N)` ('default =' `10`):: Maximal time to wait until a guest system is stopped (minutes). -`storage`: `string` :: +`storage`: `` :: Store resulting file to this storage. -`tmpdir`: `string` :: +`tmpdir`: `` :: Store temporary files to specified directory. +`zstd`: `` ('default =' `1`):: + +Zstd threads. N=0 uses half of the available cores, N>0 uses N as thread count. +