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

[Ishani Chugh]

Signed-off-by: Ishani Chugh <address@hidden>
---
 Makefile                        |   2 +-
 contrib/backup/qemu-backup.texi | 147 ++++++++++++++++++++++++++++++++++++++++
 2 files changed, 148 insertions(+), 1 deletion(-)
 create mode 100644 contrib/backup/qemu-backup.texi

diff --git a/Makefile b/Makefile
index c830d7a..f42cb1d 100644
--- a/Makefile
+++ b/Makefile
@@ -504,7 +504,7 @@ clean:
 VERSION ?= $(shell cat VERSION)
 
 dist: qemu-$(VERSION).tar.bz2
-
+qemu-backup.8: contrib/qemu-backup/qemu-backup.texi
 qemu-%.tar.bz2:
        $(SRC_PATH)/scripts/make-release "$(SRC_PATH)" "$(patsubst 
qemu-%.tar.bz2,%,$@)"
 
diff --git a/contrib/backup/qemu-backup.texi b/contrib/backup/qemu-backup.texi
new file mode 100644
index 0000000..41e2b16
--- /dev/null
+++ b/contrib/backup/qemu-backup.texi
@@ -0,0 +1,147 @@
+                   
+ 
address@hidden qemu-backup-tool-manpage
+
address@hidden en
address@hidden UTF-8
+
+\input texinfo
address@hidden Manpage_backup_tool 1.0
address@hidden
+This is a manpage for qemu_backup_tool, version 1.0.
+
+Copyright @copyright{} 2016 Free Software Foundation, Inc.
address@hidden copying
address@hidden
address@hidden
+* QEMU: (qemu-backup-tool-manpage).    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 @titlefont{Man Page}
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 chapter, first dummy
address@hidden
address@hidden qemu-backup guest add [--id id] [--qmp socketpath]
address@hidden qemu-backup guest list
address@hidden qemu-backup drive add [--guest guestname] [--id driveid] 
[--target target]
address@hidden qemu-backup drive list [--guest guestname]
address@hidden qemu-backup backup [--guest guestname]
address@hidden qemu-backup restore [--guest guestname]
address@hidden qemu-backup drive-remove [--guest guestname] [--id driveid]
address@hidden qemu-backup remove [--guest guestname]
address@hidden qemu-backup drive add [--all] [--guest guestname] [--target 
target]
address@hidden qemu-backup backup [--inc] [--guest guestname]
address@hidden itemize
address@hidden  Command Parameters
address@hidden  Command Parameters
address@hidden chapter, first dummy
address@hidden
address@hidden --guest: Name of the guest.
address@hidden --id: id of guest or drive.
address@hidden --target: Destination on which you want your backup to be made.
address@hidden --all: Add all the drives present in a guest for backup except 
cd-rom.
address@hidden --inc: For incremental backup.
address@hidden --qmp: Path of qmp socket.
address@hidden itemize
+
address@hidden  Command Descriptions
address@hidden  Command Descriptions
address@hidden chapter, first dummy
address@hidden
address@hidden qemu-backup guest add [--id id] [--qmp socketpath]
+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
+ 
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/fedora/root.img
+qemu-backup drive add --guest=fedora --id=data
+--target=/backup/fedora/data.img
+ 
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
+cp /backup/fedora/root.img /var/run/qemu/fedora/root.img
+cp /backup/fedora/data.img /var/run/qemu/fedora/data.img
+ 
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: qemu-backup remove --guest=fedora --id=root
+ 
address@hidden qemu-backup remove [--guest guestname]
+This command removes the guest from the configuration file.
+example: qemu-backup remove –guest=fedora
+ 
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. 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 itemize
+
+
address@hidden License
address@hidden License
+ 
+QEMU is a trademark of Fabrice Bellard.
+ 
+QEMU is released under the GNU General Public License (TODO: add link).
+Parts of QEMU have specific licenses, see file LICENSE.
+ 
+TODO (refer to file LICENSE, include it, include the GPL?)
+ 
+
address@hidden
+
+
+ 
+
-- 
2.7.4