From nobody Mon Feb 9 20:52:59 2026 Delivered-To: importer@patchew.org Received-SPF: pass (zoho.com: domain of gnu.org designates 208.118.235.17 as permitted sender) client-ip=208.118.235.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists.gnu.org; Authentication-Results: mx.zoho.com; dkim=fail spf=pass (zoho.com: domain of gnu.org designates 208.118.235.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; Return-Path: Received: from lists.gnu.org (lists.gnu.org [208.118.235.17]) by mx.zohomail.com with SMTPS id 1496973706077174.341870736528; Thu, 8 Jun 2017 19:01:46 -0700 (PDT) Received: from localhost ([::1]:52123 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dJ9FA-0003ct-J8 for importer@patchew.org; Thu, 08 Jun 2017 22:01:44 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:58466) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dJ52L-0001MC-Bk for qemu-devel@nongnu.org; Thu, 08 Jun 2017 17:32:14 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1dJ52G-00055v-FC for qemu-devel@nongnu.org; Thu, 08 Jun 2017 17:32:13 -0400 Received: from research.iiit.ac.in ([196.12.53.8]:52784) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1dJ52F-00053G-Fq for qemu-devel@nongnu.org; Thu, 08 Jun 2017 17:32:08 -0400 Received: from localhost (localhost [127.0.0.1]) by research.iiit.ac.in (Postfix) with ESMTP id 0925F741B5A; Fri, 9 Jun 2017 03:02:00 +0530 (IST) Received: from research.iiit.ac.in ([127.0.0.1]) by localhost (research.iiit.ac.in [127.0.0.1]) (amavisd-new, port 10032) with ESMTP id yQd2RW6N1U4c; Fri, 9 Jun 2017 03:01:58 +0530 (IST) Received: from localhost (localhost [127.0.0.1]) by research.iiit.ac.in (Postfix) with ESMTP id 72D42741B72; Fri, 9 Jun 2017 03:01:58 +0530 (IST) Received: from research.iiit.ac.in ([127.0.0.1]) by localhost (research.iiit.ac.in [127.0.0.1]) (amavisd-new, port 10026) with ESMTP id 8zv54qrA0gFo; Fri, 9 Jun 2017 03:01:58 +0530 (IST) Received: from ishani-Inspiron-5558.iiit.ac.in (unknown [10.1.97.126]) by research.iiit.ac.in (Postfix) with ESMTPSA id 500AA741B5A; Fri, 9 Jun 2017 03:01:58 +0530 (IST) DKIM-Filter: OpenDKIM Filter v2.9.2 research.iiit.ac.in 72D42741B72 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=research.iiit.ac.in; s=4E8815E6-5B55-11E4-B758-8D4964374E96; t=1496957518; bh=QI3KAqZGNHV7Az8Cgm6BA6Gh77cTa2tf8SqNeUL15ko=; h=From:To:Subject:Date:Message-Id:MIME-Version:Content-Type: Content-Transfer-Encoding; b=IcOjOUnW0xz2RA+9equpawVLwCP9nLuPB2jFl5ilz7gZbSHWmyv7Jw1mF4qkyXH/t ODbi+qhSosErZMoooCJI0isOAqaIKQUgYOVSYaVQ8SIVeg8vLDni4Aklq3fJGvP3HD tihc95L3gpBiIsk0cswphFSyVlRxYyyMUEtiS5Ak= X-Virus-Scanned: amavisd-new at research.iiit.ac.in From: Ishani Chugh To: qemu-devel@nongnu.org Date: Fri, 9 Jun 2017 03:01:38 +0530 Message-Id: <1496957498-17127-1-git-send-email-chugh.ishani@research.iiit.ac.in> X-Mailer: git-send-email 2.7.4 MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] [fuzzy] X-Received-From: 196.12.53.8 X-Mailman-Approved-At: Thu, 08 Jun 2017 21:58:26 -0400 Subject: [Qemu-devel] [PATCH] Add manpage for QEMU Backup Tool X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Ishani Chugh , jsnow@redhat.com, stefanha@redhat.com Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: "Qemu-devel" X-ZohoMail-DKIM: fail (Header signature does not verify) X-ZohoMail: RDKM_2 RSF_0 Z_629925259 SPT_0 Content-Type: text/plain; charset="utf-8" Signed-off-by: Ishani Chugh --- 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 ?=3D $(shell cat VERSION) =20 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= ,%,$@)" =20 diff --git a/contrib/backup/qemu-backup.texi b/contrib/backup/qemu-backup.t= exi new file mode 100644 index 0000000..41e2b16 --- /dev/null +++ b/contrib/backup/qemu-backup.texi @@ -0,0 +1,147 @@ + =20 +=20 +@setfilename qemu-backup-tool-manpage + +@documentlanguage en +@documentencoding UTF-8 + +\input texinfo +@settitle Manpage_backup_tool 1.0 +@copying +This is a manpage for qemu_backup_tool, version 1.0. + +Copyright @copyright{} 2016 Free Software Foundation, Inc. +@end copying +@ifinfo +@direntry +* QEMU: (qemu-backup-tool-manpage). Man page for QEMU backup tool. +@end direntry +@end ifinfo +@iftex +@titlepage +@sp 7 +@center @titlefont{QEMU_backup_tool} +@sp 1 +@center @titlefont{Man Page} +@sp 3 +@end titlepage +@end iftex +@ifnottex +@node Top +@top Short Sample + +@menu +* Name:: +* Synopsis:: +* list of Commands:: +* Command Parameters:: +* Command Descriptions:: +* License:: +@end menu + +@end ifnottex + +@node Name +@chapter Name + +QEMU disk backup tool. + +@node Synopsis +@chapter Synopsis + + +qemu-backup command [ command options]. + +@node list of Commands +@chapter list of Commands +@cindex chapter, first dummy +@itemize +@item qemu-backup guest add [--id id] [--qmp socketpath] +@item qemu-backup guest list +@item qemu-backup drive add [--guest guestname] [--id driveid] [--target t= arget] +@item qemu-backup drive list [--guest guestname] +@item qemu-backup backup [--guest guestname] +@item qemu-backup restore [--guest guestname] +@item qemu-backup drive-remove [--guest guestname] [--id driveid] +@item qemu-backup remove [--guest guestname] +@item qemu-backup drive add [--all] [--guest guestname] [--target target] +@item qemu-backup backup [--inc] [--guest guestname] +@end itemize +@node Command Parameters +@chapter Command Parameters +@cindex chapter, first dummy +@itemize +@item --guest: Name of the guest. +@item --id: id of guest or drive. +@item --target: Destination on which you want your backup to be made. +@item --all: Add all the drives present in a guest for backup except cd-ro= m. +@item --inc: For incremental backup. +@item --qmp: Path of qmp socket. +@end itemize + +@node Command Descriptions +@chapter Command Descriptions +@cindex chapter, first dummy +@itemize +@item 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=3Dfedora =E2=80=93qmp=3D/var/run/qemu/fedora.so= ck +=20 +@item qemu-backup guest list +This commands lists the names of guests which are added to configuration f= ile. +=20 +@item qemu-backup drive add [--guest guestname] [--id driveid] [--target t= arget] +This command adds different drives for backup in a particular guest by giv= ing 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=3Dfedora --id=3Droot +--target=3D/backup/fedora/root.img +qemu-backup drive add --guest=3Dfedora --id=3Ddata +--target=3D/backup/fedora/data.img +=20 +@item qemu-backup drive list [--guest guestname] +This commands gives the names of the drive present in a guest which are ad= ded for backup. +example: qemu-backup drive list --guest=3Dfedora +=20 +@item qemu-backup backup [--guest guestname] +=20 +This command makes the backup of the drives, in their respective given des= tinations. The ids of drive and their destinations are taken from the confi= guration file. +example: qemu-backup backup --guest=3Dfedora +=20 +@item 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=3Dfedora +cp /backup/fedora/root.img /var/run/qemu/fedora/root.img +cp /backup/fedora/data.img /var/run/qemu/fedora/data.img +=20 +@item 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=3Dfedora --id=3Droot +=20 +@item qemu-backup remove [--guest guestname] +This command removes the guest from the configuration file. +example: qemu-backup remove =E2=80=93guest=3Dfedora +=20 +@item qemu-backup drive add --all [-guest guestname] [-destination destina= tion] +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 driv= es and target will be the destination folder. +example: qemu-backup drive add --all --guest fedora --destination =3D/back= up/fedora/ +=20 +@end itemize + + +@node License +@appendix License +=20 +QEMU is a trademark of Fabrice Bellard. +=20 +QEMU is released under the GNU General Public License (TODO: add link). +Parts of QEMU have specific licenses, see file LICENSE. +=20 +TODO (refer to file LICENSE, include it, include the GPL?) +=20 + +@bye + + +=20 + --=20 2.7.4