X-Git-Url: https://git.proxmox.com/?a=blobdiff_plain;f=vzdump.conf.5-opts.adoc;h=21b96e87885f824135f5ec6cca04011fe9249dfa;hb=4e8fe2a9599c40ec04565091b1b1f5930d966e00;hp=d8bf641b7900afa6a9c09b693a75f3967694b189;hpb=c2993fe56c757a6b53001af4b2af6517ef598f1e;p=pve-docs.git diff --git a/vzdump.conf.5-opts.adoc b/vzdump.conf.5-opts.adoc index d8bf641..21b96e8 100644 --- a/vzdump.conf.5-opts.adoc +++ b/vzdump.conf.5-opts.adoc @@ -1,68 +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`: `` :: 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. -`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. +