[pve-docs.git] / vzdump.1-synopsis.adoc

*vzdump* `help`

*vzdump* `{<vmid>}` `[OPTIONS]`

Create backup.

`<vmid>` `string` ::

The ID of the guest system you want to backup.

`-all` `boolean` (default=`0`)::

Backup all known guest systems on this host.

`-bwlimit` `integer (0 - N)` (default=`0`)::

Limit I/O bandwidth (KBytes per second).

`-compress` `(0 | 1 | gzip | lzo)` (default=`0`)::

Compress dump file.

`-dumpdir` `string` ::

Store resulting files to specified directory.

`-exclude` `string` ::

Exclude specified guest systems (assumes --all)

`-exclude-path` `string` ::

Exclude certain files/directories (shell globs).

`-ionice` `integer (0 - 8)` (default=`7`)::

Set CFQ ionice priority.

`-lockwait` `integer (0 - N)` (default=`180`)::

Maximal time to wait for the global lock (minutes).

`-mailnotification` `(always | failure)` (default=`always`)::

Specify when to send an email

`-mailto` `string` ::

Comma-separated list of email addresses that should receive email
notifications.

`-maxfiles` `integer (1 - N)` (default=`1`)::

Maximal number of backup files per guest system.

`-mode` `(snapshot | stop | suspend)` (default=`snapshot`)::

Backup mode.

`-node` `string` ::

Only run if executed on this node.

`-pigz` `integer` (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`)::

Be quiet.

`-remove` `boolean` (default=`1`)::

Remove old backup files if there are more than 'maxfiles' backup files.

`-script` `string` ::

Use specified hook script.

`-size` `integer (500 - N)` (default=`1024`)::

Unused, will be removed in a future release.

`-stdexcludes` `boolean` (default=`1`)::

Exclude temporary files and logs.

`-stdout` `boolean` ::

Write tar to stdout, not to a file.

`-stop` `boolean` (default=`0`)::

Stop runnig backup jobs on this host.

`-stopwait` `integer (0 - N)` (default=`10`)::

Maximal time to wait until a guest system is stopped (minutes).

`-storage` `string` ::

Store resulting file to this storage.

`-tmpdir` `string` ::

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