qemu-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[Qemu-devel] [PATCH v6] Add manpage for QEMU Backup Tool


From: Ishani Chugh
Subject: [Qemu-devel] [PATCH v6] Add manpage for QEMU Backup Tool
Date: Tue, 18 Jul 2017 00:45:36 +0530

qemu-backup will be a command-line tool for performing full and
incremental disk backups on running VMs. It is intended as a
reference implementation for management stack and backup developers
to see QEMU's backup features in action. The following commit is an
initial implementation of manpage listing the commands which the
backup tool will support. The manpage wil be build along with other
docs when configure is provided with --enable-docs flag in the
location contrib/backup in build directory.

Signed-off-by: Ishani Chugh <address@hidden>
---
 Makefile                        |  14 +++--
 contrib/backup/qemu-backup.texi | 135 ++++++++++++++++++++++++++++++++++++++++
 2 files changed, 145 insertions(+), 4 deletions(-)
 create mode 100644 contrib/backup/qemu-backup.texi

diff --git a/Makefile b/Makefile
index 16a0430..500c6e8 100644
--- a/Makefile
+++ b/Makefile
@@ -209,6 +209,7 @@ ifdef BUILD_DOCS
 DOCS=qemu-doc.html qemu-doc.txt qemu.1 qemu-img.1 qemu-nbd.8 qemu-ga.8
 DOCS+=docs/interop/qemu-qmp-ref.html docs/interop/qemu-qmp-ref.txt 
docs/interop/qemu-qmp-ref.7
 DOCS+=docs/interop/qemu-ga-ref.html docs/interop/qemu-ga-ref.txt 
docs/interop/qemu-ga-ref.7
+DOCS+=contrib/backup/qemu-backup.html contrib/backup/qemu-backup.txt
 ifdef CONFIG_VIRTFS
 DOCS+=fsdev/virtfs-proxy-helper.1
 endif
@@ -508,6 +509,8 @@ VERSION ?= $(shell cat VERSION)
 
 dist: qemu-$(VERSION).tar.bz2
 
+qemu-backup.8: contrib/backup/qemu-backup.texi
+
 qemu-%.tar.bz2:
        $(SRC_PATH)/scripts/make-release "$(SRC_PATH)" "$(patsubst 
qemu-%.tar.bz2,%,$@)"
 
@@ -719,16 +722,19 @@ fsdev/virtfs-proxy-helper.1: 
fsdev/virtfs-proxy-helper.texi
 qemu-nbd.8: qemu-nbd.texi qemu-option-trace.texi
 qemu-ga.8: qemu-ga.texi
 
-html: qemu-doc.html docs/interop/qemu-qmp-ref.html 
docs/interop/qemu-ga-ref.html
-info: qemu-doc.info docs/interop/qemu-qmp-ref.info 
docs/interop/qemu-ga-ref.info
-pdf: qemu-doc.pdf docs/interop/qemu-qmp-ref.pdf docs/interop/qemu-ga-ref.pdf
-txt: qemu-doc.txt docs/interop/qemu-qmp-ref.txt docs/interop/qemu-ga-ref.txt
+html: qemu-doc.html docs/interop/qemu-qmp-ref.html 
docs/interop/qemu-ga-ref.html contrib/backup/qemu-backup.html
+info: qemu-doc.info docs/interop/qemu-qmp-ref.info 
docs/interop/qemu-ga-ref.info contrib/backup/qemu-backup.info
+pdf: qemu-doc.pdf docs/interop/qemu-qmp-ref.pdf docs/interop/qemu-ga-ref.pdf 
contrib/backup/qemu-backup.pdf
+txt: qemu-doc.txt docs/interop/qemu-qmp-ref.txt docs/interop/qemu-ga-ref.txt 
contrib/backup/qemu-backup.txt
 
 qemu-doc.html qemu-doc.info qemu-doc.pdf qemu-doc.txt: \
        qemu-img.texi qemu-nbd.texi qemu-options.texi qemu-option-trace.texi \
        qemu-monitor.texi qemu-img-cmds.texi qemu-ga.texi \
        qemu-monitor-info.texi
 
+contrib/backup/qemu-backup.html contrib/backup/qemu-backup.pdf 
contrib/backup/qemu-backup.txt contrib/backup/qemu-backup.info: \
+       contrib/backup/qemu-backup.texi
+
 docs/interop/qemu-ga-ref.dvi docs/interop/qemu-ga-ref.html \
     docs/interop/qemu-ga-ref.info docs/interop/qemu-ga-ref.pdf \
     docs/interop/qemu-ga-ref.txt docs/interop/qemu-ga-ref.7: \
diff --git a/contrib/backup/qemu-backup.texi b/contrib/backup/qemu-backup.texi
new file mode 100644
index 0000000..ba9f9ec
--- /dev/null
+++ b/contrib/backup/qemu-backup.texi
@@ -0,0 +1,135 @@
+\input texinfo
address@hidden qemu-backup
+
address@hidden en
address@hidden UTF-8
+
address@hidden QEMU Backup Tool
address@hidden
+
+Copyright @copyright{} 2017 The QEMU Project developers
address@hidden copying
address@hidden
address@hidden
+* QEMU: (QEMU-backup).    Man page for QEMU Backup Tool.
address@hidden direntry
address@hidden ifinfo
address@hidden
address@hidden
address@hidden 7
address@hidden @titlefont{QEMU Backup Tool}
address@hidden 1
address@hidden 3
address@hidden titlepage
address@hidden iftex
address@hidden
address@hidden Top
address@hidden Short Sample
+
address@hidden
+* Name::
+* Synopsis::
+* List of Commands::
+* Command Parameters::
+* Command Descriptions::
+* License::
address@hidden menu
+
address@hidden ifnottex
+
address@hidden Name
address@hidden Name
+
+QEMU disk backup tool.
+
address@hidden Synopsis
address@hidden Synopsis
+
+qemu-backup command [command options].
+
address@hidden  List of Commands
address@hidden  List of Commands
address@hidden
address@hidden qemu-backup guest add --guest guestname --qmp socketpath [--tcp]
address@hidden qemu-backup guest list
address@hidden qemu-backup drive add --id driveid --guest guestname --target 
target
address@hidden qemu-backup drive add --all --guest guestname --target target
address@hidden qemu-backup drive list --guest guestname
address@hidden qemu-backup backup [--inc] --guest guestname
address@hidden qemu-backup restore --guest guestname
address@hidden qemu-backup guest remove --guest guestname
address@hidden qemu-backup drive remove --guest guestname --id driveid
address@hidden itemize
address@hidden  Command Parameters
address@hidden  Command Parameters
address@hidden
address@hidden --all: Add all the drives present in a guest which are suitable 
for backup.
address@hidden --guest: Name of the guest.
address@hidden --id: id of guest or drive.
address@hidden --inc: (Optional) For incremental backup.
address@hidden --qmp: Path of qmp socket.
address@hidden --target: Destination path on which you want your backup to be 
made.
address@hidden --tcp: (Optional) Specifies TCP socket.
address@hidden itemize
+
address@hidden  Command Descriptions
address@hidden  Command Descriptions
address@hidden
address@hidden qemu-backup guest add --guest guestname --qmp socketpath [--tcp]
+This command adds a guest to the configuration file given its path to qmp 
socket.
+
+example:
+qemu-backup guest add --id=fedora --qmp=/var/run/qemu/fedora.sock
+
+qemu-backup guest add --id=fedora --qmp=localhost:4444 --tcp
+
address@hidden qemu-backup guest list
+This commands lists the names of guests which are added to configuration file.
+
address@hidden qemu-backup drive add --guest guestname --id driveid --target 
target
+This command adds different drives for backup in a particular guest by giving 
the name of drive to be backed up and target imagefile in which we want to 
store the drive backup.
+
+example: qemu-backup drive add --guest=fedora --id=root 
--target=/backup/root.img
+
address@hidden qemu-backup drive add --all --guest guestname --destination 
destination
+This command adds all the drives of the guest for backup other than CDROM 
drive and read-only drives. Here all the backup drives will have the same names 
as original drives and target will be the destination folder.
+
+example: qemu-backup drive add --all --guest fedora --destination 
=/backup/fedora/
+
address@hidden qemu-backup drive list --guest guestname
+This commands gives the names of the drive present in a guest which are added 
for backup.
+
+example: qemu-backup drive list --guest=fedora
+
address@hidden qemu-backup backup --guest guestname
+
+This command makes the backup of the drives, in their respective given 
destinations. The ids of drive and their destinations are taken from the 
configuration file.
+
+example: qemu-backup backup --guest=fedora
+
address@hidden qemu-backup restore --guest guestname
+This command is needed if we want to restore the backup. It will list the 
commands to be run for performing the same but will not perform any action.
+
+example: qemu-backup restore --guest=fedora
+
address@hidden qemu-backup guest remove --guest guestname
+This command removes the guest from the configuration file.
+
+example: qemu-backup guest remove --guest=fedora
+
address@hidden qemu-backup drive remove --guest guestname --id driveid
+This command helps remove a drive which is set for backup in configuration of 
given host.
+
+example: drive remove --guest=fedora --id=root
+
+
address@hidden itemize
+
address@hidden License
address@hidden License
+QEMU is a trademark of Fabrice Bellard.
+QEMU is released under the
address@hidden://www.gnu.org/licenses/gpl-2.0.txt,GNU General Public License},
+version 2. Parts of QEMU have specific licenses, see file
address@hidden://git.qemu.org/?p=qemu.git;a=blob_plain;f=LICENSE,LICENSE}.
address@hidden
-- 
2.7.4




reply via email to

[Prev in Thread] Current Thread [Next in Thread]