--- /dev/null
+#!/usr/bin/perl
+
+use lib '.';
+use strict;
+use warnings;
+use PVE::RESTHandler;
+use PVE::VZDump;
+
+my $prop = PVE::VZDump::json_config_properties();
+my $skip = {
+ all => 1,
+ exclude => 1,
+ vmid => 1,
+ node => 1,
+ quiet => 1,
+ size => 1,
+ stop => 1,
+};
+
+my $filterFn = sub {
+ my ($k, $phash) = @_;
+
+ return $skip->{$k} || 0;
+};
+
+print PVE::RESTHandler::dump_properties($prop, 'asciidoc', 'config', $filterFn);
be found online
https://git.proxmox.com/?p=pve-qemu-kvm.git;a=blob;f=backup.txt[here].
+NOTE: Qemu backup provides snapshots on any storage type. It does
+not require that the underlying storage supports snapshots.
+
.Backup `mode` for Containers:
Configuration
-------------
-Global configuration is stored in '/etc/vzdump.conf'.
-
- tmpdir: DIR
- dumpdir: DIR
- storage: STORAGE_ID
- mode: snapshot|suspend|stop
- bwlimit: KBPS
- ionize: PRI
- lockwait: MINUTES
- stopwait: MINUTES
- size: MB
- maxfiles: N
- script: FILENAME
- exclude-path: PATHLIST
+Global configuration is stored in '/etc/vzdump.conf'. The file uses a
+simple colon separated key/value format. Each line has the following
+format:
+
+ OPTION: value
+
+Blank lines in the file are ignored, and lines starting with a '#'
+character are treated as comments and are also ignored.
+
+We currently support the following options:
+
+include::vzdump.conf.5-opts.adoc[]
+
+
+.Example 'vzdump.conf' Configuration
+----
+tmpdir: /mnt/fast_local_disk
+storage: my_backup_storage
+mode: snapshot
+bwlimit: 10000
+----
Hook Scripts
------------
--- /dev/null
+`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-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` ::
+
+no description available
+
+`maxfiles`: `integer (1 - N)` (default=`1`)::
+
+Maximal number of backup files per guest system.
+
+`mode`: `(snapshot | stop | suspend)` (default=`snapshot`)::
+
+Backup mode.
+
+`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.
+
+`remove`: `boolean` (default=`1`)::
+
+Remove old backup files if there are more than 'maxfiles' backup files.
+
+`script`: `string` ::
+
+Use specified hook script.
+
+`stdexcludes`: `boolean` (default=`1`)::
+
+Exclude temporary files and logs.
+
+`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.
+