X-Git-Url: https://git.proxmox.com/?a=blobdiff_plain;f=vzdump.1-synopsis.adoc;h=369daae9fd6bde4d37752a538422006847c1cb55;hb=95e8e1b7663515772b476194a05d6f74c965a4f3;hp=8f9fce806ef2dc21038fce9500118cc37523fb6f;hpb=c2993fe56c757a6b53001af4b2af6517ef598f1e;p=pve-docs.git diff --git a/vzdump.1-synopsis.adoc b/vzdump.1-synopsis.adoc index 8f9fce8..369daae 100644 --- a/vzdump.1-synopsis.adoc +++ b/vzdump.1-synopsis.adoc @@ -4,103 +4,111 @@ Create backup. -`` `string` :: +``: `` :: The ID of the guest system you want to backup. -`-all` `boolean` (default=`0`):: +`--all` `` ('default =' `0`):: Backup all known guest systems on this host. -`-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` `string` :: +`--exclude` `` :: Exclude specified guest systems (assumes --all) -`-exclude-path` `string` :: +`--exclude-path` `` :: -Exclude certain files/directories (shell globs). +Exclude certain files/directories (shell globs). Paths starting with '/' are anchored to the container's root, other paths match relative to each subdirectory. -`-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. +Comma-separated list of email addresses or users that should receive email notifications. -`-maxfiles` `integer (1 - N)` (default=`1`):: +`--maxfiles` ` (1 - N)` :: -Maximal number of backup files per guest system. +Deprecated: use 'prune-backups' instead. Maximal number of backup files per guest system. -`-mode` `(snapshot | stop | suspend)` (default=`snapshot`):: +`--mode` `` ('default =' `snapshot`):: Backup mode. -`-node` `string` :: +`--node` `` :: Only run if executed on this node. -`-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. -`-quiet` `boolean` (default=`0`):: +`--pool` `` :: -Be quiet. +Backup all known guest systems included in the specified pool. -`-remove` `boolean` (default=`1`):: +`--prune-backups` `[keep-all=<1|0>] [,keep-daily=] [,keep-hourly=] [,keep-last=] [,keep-monthly=] [,keep-weekly=] [,keep-yearly=]` ('default =' `keep-all=1`):: -Remove old backup files if there are more than 'maxfiles' backup files. +Use these retention options instead of those from the storage configuration. -`-script` `string` :: +`--quiet` `` ('default =' `0`):: -Use specified hook script. +Be quiet. + +`--remove` `` ('default =' `1`):: -`-size` `integer (500 - N)` (default=`1024`):: +Prune older backups according to 'prune-backups'. -Unused, will be removed in a future release. +`--script` `` :: -`-stdexcludes` `boolean` (default=`1`):: +Use specified hook script. + +`--stdexcludes` `` ('default =' `1`):: Exclude temporary files and logs. -`-stdout` `boolean` :: +`--stdout` `` :: Write tar to stdout, not to a file. -`-stop` `boolean` (default=`0`):: +`--stop` `` ('default =' `0`):: -Stop runnig backup jobs on this host. +Stop running backup jobs on this host. -`-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. +